Delete an Aria Agent Cloud Agent Definition

Delete an agent definition. Existing sessions keep their historical link to the deleted agent for audit, but no new sessions or turns can be started against it.

Endpoint

DELETE /v1/agents/{agent_id}

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <api_key>.

Path parameters

string

required

Agent identifier.

Response

string

Deleted agent identifier.

string

Always agent.deleted.

boolean

Always true on success.

Example

curl -X DELETE https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"

{
  "id": "ag_0198a...",
  "object": "agent.deleted",
  "deleted": true
}

PIN API

ROUTER API

AGENT API

Delete an Aria Agent Cloud Agent Definition

Endpoint

Authentication

Path parameters

Response

Example

​Endpoint

​Authentication

​Path parameters

​Response

​Example

Endpoint

Authentication

Path parameters

Response

Example