Authorize a custom domain
POST/api/v1/chatbots/:chatbotId/domains
Adds a custom domain to the chatbot's authorized login domain list. Requires a paid plan tier that supports custom domains. On success returns the updated domain status. On failure (the domain authorization call failed) returns 400 with PublicDomainStatus (status: pending_manual) or a standard Error envelope for validation/config failures. Required scope: domains:write.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
Domain authorized.
Bad Request — either a validation/config error (Error envelope) or a soft-failure where domain authorization failed but manual DNS setup is possible (PublicDomainStatus with status: pending_manual).
Unauthorized — missing or invalid API key
Forbidden — key lacks required scope
Not Found
Too Many Requests — rate limit exceeded