Devices
Dead-man heartbeat (device only, while active)
Send every few seconds while the session is active OR paused; optional body {last_command_at, last_seq, task_running} extends the lease (last_seq must be an integer 0..2147483647, 422 otherwise, and only counts when it advances) (idle limit 2 min unattended, 5 supervised; an idle agent ends agent_idle). task_running: true says a whole task is running (many model turns and commands the server never sees); it extends the lease like a command, but only under a grant that carries device.task, and never past max_duration_s. 15 seconds of silence ends it with end_reason lost_contact. A 409 means the session is over and the device must stop.
post/api/v1/device_sessions/{id}/beat
Request
- Base URL: https://saltapp.ai
- URL: https://saltapp.ai/api/v1/device_sessions/{id}/beat
- Auth: API key in header api-key
Path parameters
idstring required
Response
OK.
object required
Changes
No recorded changes to this operation across all 3 revisions of this API.