Delete an Agent

Delete an agent and clean up its resources. For managed agents, this remotely uninstalls the agent from the host GPU node over SSH. All associated training jobs are cascaded and removed before the agent record is deleted.

Endpoint

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

Path parameters

string

required

Agent identifier, e.g. ag_7f8e9d0c.

Response

On success, the response shape returned by the handler is consistent with other success patterns.

boolean

True when the deletion succeeds.

Example

curl -s -X DELETE http://<pin-host>:8001/v1/agents/ag_7f8e9d0c \
  -H "Authorization: Bearer $ARIA_PIN_KEY"

{
  "ok": true
}

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

Endpoint

DELETE /v1/agents/{id}

Authentication

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

Path parameters

string

required

Agent identifier returned by the fleet listing endpoints.

Response

integer

0 on success. Non-zero indicates an error; see message.

object

Deletion result envelope, typically { "ok": true }.

Example

curl -X DELETE https://ariapin.example.com/v1/agents/ag_01H7Z... \
  -H "Authorization: Bearer $ARIAPIN_API_KEY"

{
  "code": 0,
  "data": { "ok": true },
  "message": ""
}

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

PIN API

ROUTER API

AGENT API

Endpoint

Path parameters

Response

Example

Endpoint

Authentication

Path parameters

Response

Example

​Endpoint

​Path parameters

​Response

​Example

​Endpoint

​Authentication

​Path parameters

​Response

​Example

Endpoint

Path parameters

Response

Example

Endpoint

Authentication

Path parameters

Response

Example