chat-ai
chat_agents
Delete Chat Agent
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.
delete/api/v1/chat-ai/chat-agents/{chat_agent_id}
Path parameters
chat_agent_idstring uuid required
Response
Successful Response
object required
Changes
No recorded changes to this endpoint across all 2 revisions of this API.