Sign in
Daemons
internal
deprecated

Receive daemon heartbeat (DEPRECATED - for backwards compatibility with pre-v0.14.0 daemons)

Internal endpoint for legacy daemons to send periodic heartbeats. New daemons (v0.14.0+) use the /request-work endpoint which includes heartbeat functionality. This endpoint is kept for backwards compatibility and will be removed in a future version.

post/api/daemons/{id}/heartbeat

Path parameters

idstring uuid required

Daemon ID

Request body

mode'server_poll' | 'daemon_poll' required

Daemon operating mode that determines the communication pattern.

  • DaemonPoll (formerly "Pull"): Daemon makes outbound connections to the server. The daemon registers itself and polls for work. Best for daemons behind NAT/firewall.

  • ServerPoll (formerly "Push"): Server makes connections to the daemon. Server polls daemon for status and discovery results. Best for DMZ deployments where daemon cannot make outbound connections.

namestring required
urlstring required

Response

Heartbeat received

dataTupleUnit — unresolved $ref
errorstring nullable
successboolean required

Changes