v1

latestOpenAPI 3.1.0MIT2026-08-0481194343.8 KB

machines

Renew an external-machine driver lease

DEVICE TOKEN ONLY. Refreshes connection_status and last_seen_at using the current fencing_token and returns authoritative last_sequence/last_frame_id recovery state. A restarted driver can long-poll once to learn the current fence, heartbeat, then submit sequence=last_sequence+1. A revoked machine or stale lease generation is rejected; heartbeats never revive an old device token.

post/v1/machines/{machine_id}/heartbeat

Request body

protocol_version'1'

fencing_tokeninteger required

Response

Lease renewed.

machine_idstring required

connection_status'connected' required

last_seen_atstring date-time required

fencing_tokeninteger required

last_sequenceinteger required

Authoritative last accepted observation sequence. A restarted driver submits last_sequence + 1.

last_frame_idstring uuid nullable required

Authoritative last accepted frame, or null before the first observation.

request_idstring required