Manual Reboot
POST
/api/v1/integrations/devices/rebootIntegration APIManually trigger a reboot on a device. This endpoint uses the Integration API (requires_public_auth): send a Bearer access token (e.g. client credentials) in the Authorization header. The server validates the token, resolves the account and device, then publishes the reboot command over MQTT.
Authentication
Bearer access tokenContent-Type
application/jsonHeaders
| Header | Value | Required |
|---|---|---|
Authorization | Bearer <access_token> | Yes |
Content-Type | application/json | Yes |
Request Body Parameters
| Field | Type | Required | Description |
|---|---|---|---|
serial_number | string | Yes | Device serial number. |
port | integer | Yes | Port number to reboot (1-8). |
power_off_for | integer | No | Power-off duration in seconds (default 10, range 1-300). |
reason_for_reboot | string | No | Reason for the reboot (default "Public API reboot"). |
Responses
| HTTP | Description |
|---|---|
| 200 | Reboot command accepted (`success`, `data` with message, serial, port; may include `request_id`). |
| 401 | Unauthorized — invalid or missing Bearer token. |
| 403 | Forbidden — device not allowed for this account. |
| 404 | Account or device not found. |
| 500 | Server or MQTT publish error (`success: false`, error text). |
Response
Success Response (200 OK)
Response Fields
| Field | Type | Description |
|---|---|---|
success | boolean | Indicates whether the reboot command was accepted. |
data.message | string | Human-readable confirmation message. |
data.serial_number | string | Device serial number that will be rebooted. |
data.port | integer | Port number that will be rebooted. |
Last updated on