API ReferenceAgents
Delete an agent
DELETE /api/v1/agents/{agent_uuid} — soft-delete (archive). Historical calls keep their references.
DELETE /api/v1/agents/{agent_uuid}Soft-delete an agent by archiving it. The row stays in the database so historical call references remain intact — the agent simply disappears from the default GET /agents list view.
It's archive, not destroy
Past calls that ran with this agent keep their agentId reference and continue to render correctly. The agent vanishes from ?status=active lists and can't be selected for new calls. List with ?status=archived to find it again.
Authentication
X-API-Key: zsk_...Path parameters
| Param | Type | Description |
|---|---|---|
agent_uuid | string (UUID) | The uuid of the agent. |
Response
204 No Content — no body.
Examples
curl -X DELETE https://dashboard.zoxa.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000 \
-H "X-API-Key: zsk_..."const res = await fetch(`https://dashboard.zoxa.ai/api/v1/agents/${agentUuid}`, {
method: "DELETE",
headers: { "X-API-Key": "zsk_..." },
});
console.log(res.status); // 204import httpx
r = httpx.delete(
f"https://dashboard.zoxa.ai/api/v1/agents/{agent_uuid}",
headers={"X-API-Key": "zsk_..."},
)
assert r.status_code == 204Errors
| Status | detail | When |
|---|---|---|
400 | "No organization selected" | Auth missing org. |
404 | "Agent not found" | UUID doesn't exist in your org. |
Related
GET /agents?status=archived— list archived agents