Errors

Authentication and access errors generally return:

json

{
  "error": "workspace_forbidden",
  "error_description": "Token does not have access to this workspace",
  "request_id": "REQUEST_ID"
}

HTTP 401 means invalid credentials; 403 means missing permission or a disallowed origin; 404 means a missing resource. Validation commonly uses 422. Deploy and chat errors may use error_key and error_message. Phone-verification service errors use { "error": { "code": "...", "message": "..." } }. Retain request_id when the response includes one.

Errors ​

Errors