---
title: "Delete Chat Agent"
method: DELETE
path: "/api/v1/chat-ai/chat-agents/{chat_agent_id}"
tags: ["chat-ai", "chat_agents"]
---

# Delete Chat Agent

`DELETE /api/v1/chat-ai/chat-agents/{chat_agent_id}`

Delete a specialist chat agent (superadmin only).

Refuses a group head or the tenant's default with 409 — those must be
re-pointed first. Otherwise the agent is pruned from any group it belongs to
(each re-provisioned) and deleted.

**Destructive cascade:** ``Conversation.chat_agent_id`` and
``ConversationMessage.conversation_id`` are ``ON DELETE CASCADE``, so deleting a
chat agent permanently removes every conversation and message held against it.
The cockpit must confirm this with the operator before calling this route.

## Path parameters

- `chat_agent_id` string, uuid, required

## Response `200`

Successful Response

- object

## Other responses

- `403` — Not a platform super-admin
- `404` — Chat agent not found
- `409` — The agent is a group head or the tenant default and cannot be deleted
- `422` — Validation Error

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-03** `d65b8fefae34` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/getanana/apis/cleon-api/changes/api/v1/chat-ai/chat-agents/:chat_agent_id/delete.md)

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getanana/apis/cleon-api/revisions/94579f820778?raw)