daemon

Claim Next Job

Long-poll for the next job assigned to this daemon's agent.

wait (0..DAEMON_POLL_MAX_WAIT_SECONDS) is the maximum time the handler holds the connection waiting for work. Returns:

  • 200 + DaemonJobOut once a job has been claimed.
  • 204 No Content if no job arrives within wait seconds.

Concurrency rule (AC-CONNECT-Q5): if an in-flight unresolved claim already exists for this agent, returns 409 Conflict.

Visibility timeout (AC-CONNECT-Q2): if claimed_at is older than DAEMON_VISIBILITY_TIMEOUT_SECONDS, the job is re-eligible. We issue a NEW claim_token on re-claim — a result POST with the stale token from the previous claim will 401, which is correct behaviour (the previous owner is presumed dead).

get/api/v1/daemon/jobs

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/daemon/jobs
  • Auth: none declared

Query parameters

waitinteger

Response

Successful Response

job_idstring uuid required
agent_idstring uuid required
run_idstring uuid required
payloadobject required
claim_tokenstring required

Opaque token the daemon must echo back on the result POST. Equivalent to a 'do you still own this claim?' check.

Changes

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