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

# Delete Custom Agent V1

> Delete a custom agent. Existing AgentRun rows that referenced this agent are NOT cascaded; they retain custom_agent_id for audit but lose the linked row…

Delete a custom agent.

Existing AgentRun rows that referenced this agent are NOT cascaded;
they retain `custom_agent_id` for audit but lose the linked row.
To suspend without losing audit trail, PATCH `is_active=false`.

### Path parameters

<ParamField path="agent_id" type="string (uuid)" required />

### Response

No response body. Successful Response.

### Status codes

| Code  | Meaning             |
| ----- | ------------------- |
| `204` | Successful Response |
| `422` | Validation Error    |

<RequestExample>
  ```bash cURL theme={null}
  curl --request DELETE \
    --url 'https://api.computer.stateset.app/api/v1/custom-agents/{agent_id}' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>