Delete a chatbot

DELETE 
/api/v1/chatbots/:chatbotId

Permanently deletes a chatbot and cascades its cleanup (knowledge base, storage, deployment, and configuration). Requires the chatbot OWNER or a team owner/admin (stricter than edit access). Returns 200 on full deletion, or 207 Multi-Status if the chatbot was removed but some downstream cleanup failed (see errors). Returns 409 if a shared resource (e.g. a knowledge base still used by another chatbot) blocks deletion — nothing is deleted in that case. Required scope: chatbots:write.

Request

Responses

200

Chatbot fully deleted.

207

Chatbot removed, but some downstream cleanup failed — see errors.

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

409

Conflict — a shared resource blocks deletion; nothing was deleted.

429

Too Many Requests — rate limit exceeded

500

Deletion failed (nothing deleted, or a partial cascade before an error).