Skip to main content
Delete an agent and clean up its resources. For managed agents, this uninstalls the agent from the host GPU node over SSH. Associated training jobs are removed before the agent record is deleted.

Endpoint

DELETE /v1/agents/:id Authorization: Bearer API key required.

Path parameters

string
required
Agent id, e.g. ag_7f8e9d0c.

Response

Returns { "ok": true } on success.
boolean
True when the deletion succeeds.

Example

Remove an agent from the PIN control plane. The agent stops appearing in fleet listings and gets no new jobs. In-flight jobs are not force-stopped by this call.

Endpoint

Authentication

Authorization: Bearer <api_key or JWT> with an account that manages the target agent.

Path parameters

string
required
Agent id from the fleet listing endpoints.

Response

integer
0 on success. Non-zero indicates an error; see message.
object
Deletion result envelope, usually { "ok": true }.

Example

Deleting an agent does not cancel the jobs it owns. Call the job control endpoints first if you need a graceful stop.