Create an external-API key

POST 
/api/v1/chatbots/:chatbotId/external-api/keys

Mint a new external-API key. The full plaintext key is returned ONCE in the response body (key field). Store it immediately — it cannot be retrieved again. Subsequent reads expose only the keyPrefix display hint. Maximum 5 active keys per chatbot. Required scope: security:write.

Request

Responses

201

Key created. key is the one-time plaintext value.

400

Bad Request — invalid input

401

Unauthorized — missing or invalid API key

403

Forbidden — key lacks required scope

404

Not Found

429

Too Many Requests — rate limit exceeded