Create a knowledge scope

POST 
/api/v1/chatbots/:chatbotId/scopes

Create a single knowledge scope. The scope id is derived by slugifying id (if given) else label (lowercase; [^a-z0-9_-] → -). Returns 409 if a scope with that id already exists. Unlike PATCH /scopes (which replaces the whole array), this updates one scope in place, so costLimit, authorizedEmails, and authorizedDomains are preserved. Required scope: chatbots:write.

Request

Responses

201

Scope created.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

409

Conflict — a scope with that id already exists.

429

Too Many Requests — rate limit exceeded