Skip to main content
The control channel carries lifecycle and intervention commands from the PIN control plane to node agents and returns acknowledgements. Agents poll the pending-control queue and acknowledge each command they process. User-facing lifecycle controls live under /v1/jobs/:id/* (see Lifecycle); the routes below are agent-group endpoints.
All /v1/agent/* routes, including control, require both Authorization: Bearer <jwt-or-api-key> and X-Agent-Secret: <AGENT_REGISTER_SECRET>.

Send a control command

Enqueues a command for the agent assigned to the job. The Bearer identity must own the job.
string
required
One of run, stop, resume, delete.
Returns envelope data.status from the agent acknowledgement.

Poll pending commands

Returns { "commands": [ … ] } inside data.

Acknowledge a command

string
Free-form result summary.
boolean
true if the agent could not execute the command.
Returns {"ok": true} in data.

Apply an intervention

Reports that an intervention has been applied on the training worker.
string
Agent identifier.
string
Job identifier.
string
required
Intervention identifier assigned by Intervene.
object
Hyperparameters after the intervention was applied.

List pending interventions for a job

Returns interventions the agent must apply for the job (data.items).

Fetch the job payload

Returns the full job payload for an assigned job, for agents reconnecting after a restart.

Example