Errors

Errors follow the GraphQL convention: an errors array, each entry carrying a machine-readable extensions.code. The HTTP status mirrors that code.

Error shape

json

{
  "errors": [
    {
      "message": "Conversation not found",
      "extensions": { "code": "CONVERSATION_NOT_FOUND" }
    }
  ],
  "data": null
}

Code	HTTP	Meaning
`UNAUTHENTICATED`	401	Missing or unrecognized API key.
`*_NOT_FOUND`	404	The requested resource does not exist in your organization.
`(other)`	200	Validation and execution errors return 200 with an errors array, per the GraphQL spec.

Exceeding a quota returns HTTP 429 before the query executes — see Rate Limits.