Acquire Next Pending Job for Node Agent

Node agents call this endpoint to acquire the next pending job. The controller long-polls: it returns immediately when a matching job is available, otherwise it returns 204 No Content after a bounded wait so the agent can retry.

This endpoint is called by node agents, not by end users. It requires the X-Agent-Secret header issued when the agent registers.

Endpoint

POST /v1/agent/acquire

Authentication

X-Agent-Secret: <agent_secret>.

Request body

string

required

Stable agent identifier returned by Register.

object

Current capability snapshot, including free GPU indices and VRAM.

Response

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

integer

0 on match.

object

Full job payload: job_id, type, base_model, dataset_id, lora, hyperparams, assigned_gpu_index.

Example

curl -X POST https://ariapin.example.com/v1/agent/acquire \
  -H "X-Agent-Secret: $AGENT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "ag_01", "capabilities": {"free_gpus": [0, 1]}}'

{
  "code": 0,
  "data": {
    "job_id": "job_0198a...",
    "type": "sft",
    "base_model": "meta-llama/Llama-3-8B",
    "assigned_gpu_index": 0
  },
  "message": ""
}

PIN API

ROUTER API

AGENT API

Acquire Next Pending Job for Node Agent

Endpoint

Authentication

Request body

Response

Example

​Endpoint

​Authentication

​Request body

​Response

​Example

Endpoint

Authentication

Request body

Response

Example