Skip to main content

Worker protocol

Internal HTTP used by cmd/worker. The console only calls GET /api/v1/worker/stats. Operators: Workers.

All of these require X-API-Key. Bodies are unwrapped.

MethodPathRole
POST/api/v1/worker/registerUpsert worker_heartbeats
POST/api/v1/worker/claimAtomic claim; returns JobBundle[] (pipeline + decrypted config + schemas)
POST/api/v1/worker/executions/{id}/runningMark running (409 if claim lost)
POST/api/v1/worker/executions/{id}/heartbeatExtend lease; { cancel_requested: bool }
POST/api/v1/worker/executions/{id}/finishcompleted / failed / cancelled; may requeue (scheduled)
GET/api/v1/worker/statsQueue counts, workers, leases

The worker process is an HTTP client. It has no HTTP listen port and no probes. TCP/UDP listen datasources bind a socket for the run and, when listener_services is on, publish a ClusterIP Service.