> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete an Aria Agent Cloud Agent Definition

> Delete an Aria Agent Cloud agent definition by identifier. Existing sessions retain their historical link but cannot start new turns.

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

```http theme={null}
DELETE /v1/agents/{agent_id}
```

## Authentication

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

## Path parameters

<ParamField path="agent_id" type="string" required>
  Agent identifier.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Deleted agent identifier.
</ResponseField>

<ResponseField name="object" type="string">
  Always `agent.deleted`.
</ResponseField>

<ResponseField name="deleted" type="boolean">
  Always `true` on success.
</ResponseField>

## Example

```bash theme={null}
curl -X DELETE https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json theme={null}
{
  "id": "ag_0198a...",
  "object": "agent.deleted",
  "deleted": true
}
```


## Related topics

- [Update an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/update.md)
- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)
- [Retrieve an Aria Agent Cloud Agent by ID](/api-reference/agent/agents/get.md)
- [Create Aria Agent Cloud Session for an Agent](/api-reference/agent/sessions/create.md)
- [List Aria Agent Cloud Sessions](/api-reference/agent/sessions/list.md)