Device check-in
post
https://api.flactrum.com/v1/devices/{device}/heartbeat
The device says it is alive and optionally reports its app version. A locked device stays locked — it must not be able to free itself.
| Required scope | devices.write |
| Success status | 200 |
| Returns | One Device object |
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| device * | path | string | ULID of the record. |
Request body
| Field | Type | Description |
|---|---|---|
| app_version | string|null | Reported by the device itself. |
Response fields
| Field | Type | Description |
|---|---|---|
| id | string | — |
| code | string | Unique within the brand. |
| branch_id | string|null | — |
| type | string | — |
| status | string | — |
| app_version | string|null | — |
| auto_update | boolean | — |
| last_seen_at | string|null | — |
| is_locked | boolean | — |
Examples
No recorded example yet.