Delete a knowledge scope

DELETE 
/api/v1/chatbots/:chatbotId/scopes/:scopeId

Remove one knowledge scope from a chatbot. Also unassigns the scope from the knowledge-base tree and any workflows that referenced it. Returns 409 if the scope still has documents/vectors — reassign or delete them in the dashboard first (no destructive document/vector cascade). Required scope: chatbots:write.

Request

Responses

200

Scope deleted.

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

409

Conflict — the scope still has documents/vectors.

429

Too Many Requests — rate limit exceeded