{"templateId":"GuidePage","sharedDataIds":{"sidebar":"sidebar-developers/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["callout","playground-button"]},"type":"markdown"},"seo":{"title":"Errors","description":"Developer API, partner integration, MCP, SDK, and customer help center.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"errors","__idx":0},"children":["Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["GraphQL errors return a standard ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"errors\": [...] }"]}," payload with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extensions.code"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Situation"},"children":["Situation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical response"},"children":["Typical response"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTP 401 or GraphQL auth error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid token"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication failure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GRAPHQL_VALIDATION_FAILED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Permission denied"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field or operation not allowed for app scope"]}]}]}]}]},{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"tip","title":"Debug before production"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://karzoun.chat/developer/playground"},"children":["in-app playground"]}," to validate queries and inspect error payloads."]}]},{"$$mdtype":"Tag","name":"PlaygroundButton","attributes":{"label":"Open Playground","variant":"outlined"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-fixes","__idx":1},"children":["Common fixes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["401"]}," — Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-app-token"]}," header and app ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isEnabled"]}," status"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permission denied"]}," — App user group may not include the operation; adjust scopes in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/developer/apps"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Validation"]}," — Field names and arguments must match the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developers/apis/public-api"},"children":["schema reference"]}]}]}]},"headings":[{"value":"Errors","id":"errors","depth":1},{"value":"Common fixes","id":"common-fixes","depth":2}],"frontmatter":{"title":"Errors","titleTranslationKey":"sidebar.developers.errors","audience":"developer","status":"published","locales":["en","ar"],"template":"GuidePage","seo":{"title":"Errors"}},"lastModified":"2026-06-23T09:59:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developers/guides/errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}