Skip to main content
Node agents acquire the next pending job here. The controller long-polls: it returns immediately when a matching job is available, otherwise 204 No Content after a bounded wait for the agent to retry.
All /v1/agent/* routes require both Authorization: Bearer <jwt-or-api-key> and X-Agent-Secret: <AGENT_REGISTER_SECRET>.

Endpoint

Authentication

Request body

string
required
Stable agent identifier returned by Register.
integer
Preferred GPU index on this agent.
integer
Max concurrent jobs this agent will take.

Response

Returns 204 No Content when no job is available. On a match, returns the PIN envelope with the job payload in data.

Example