COcoasty
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

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

Changes

No recorded changes to this operation across all 1 revision of this API.