Router Errors

Error and status codes returned by GraphOS Router and Apollo Router Core

Learn about error codes and HTTP response status codes returned by GraphOS Router and Apollo Router Core.

HTTP status codes

Code	Description
`400`	Bad request A request failed GraphQL validation or failed to be parsed.
`401`	Unauthorized Requests may receive this response in two cases: For a client request that requires authentication, the client's JWT failed verification. For a non-client subscription endpoint calling a subscription callback URL, the router couldn't find a matching subscription identifier between its registered subscriptions and a subscription event.
`405`	Method not allowed note Both mutations and subscriptions must use POST.
`406`	Not acceptable A request's HTTP `Accept` header didn't contain any of the router's supported mime-types: `application/json` `application/graphql-response+json` `multipart/mixed;deferSpec=20220824` `multipart/mixed;subscriptionSpec=1.0`.
`429`	Too many requests Request traffic exceeded configured rate limits. See client side traffic shaping.
`499`	Request canceled by client The request was canceled because the client closed the connection, possibly due to a client side timeout.
`500`	Internal server error The router encountered an unexpected issue. Report this possible bug to the router team.
`504`	Request timed out The request was not able to complete within a configured amount of time. See client side traffic shaping timeouts.

note

You can create Rhai scripts that throw custom status codes. See Terminating client requests to learn more.

GraphQL error codes

GraphQL error codes can appear in client responses under errors[].extensions.code, which is an established convention found in GraphQL error extensions. Learn how to see these error codes in Studio via extended error metrics.

Code	Description
`CANNOT_SEND_PQ_ID_AND_BODY`	The operation was not executed because sending a persisted query ID and a body in the same request is disallowed.
`CONNECTOR_FETCH`	There was an error fetching data from a connector service.
`COST_ESTIMATED_TOO_EXPENSIVE`	The estimated cost of the query was greater than the configured maximum cost.
`COST_ACTUAL_TOO_EXPENSIVE`	The actual cost of the query was greater than the configured maximum cost.
`COST_QUERY_PARSE_FAILURE`	The query could not be parsed.
`COST_RESPONSE_TYPING_FAILURE`	The response from a subgraph did not match the GraphQL schema.
`GATEWAY_TIMEOUT`	The request timed out when fetching data from a connector service.
`GRAPHQL_VALIDATION_FAILED`	The operation failed during GraphQL validation.
`GRAPHQL_UNKNOWN_OPERATION_NAME`	The operation could not be executed because the operation name was invalid or did not match an operation in the query document.
`HTTP_CLIENT_ERROR`	There was an error at the HTTP transport layer when fetching data from a connector service.
`MAX_ALIASES_LIMIT`	The operation was not executed due to exceeding the `max_aliases` limit.
`MAX_DEPTH_LIMIT`	The operation was not executed due to exceeding the `max_depth` limit.
`MAX_HEIGHT_LIMIT`	The operation was not executed due to exceeding the `max_height` limit.
`MAX_ROOT_FIELDS_LIMIT`	The operation was not executed due to exceeding the `max_root_fields` limit.
`QUERY_NOT_IN_SAFELIST`	The operation was not executed because it was not found in the persisted query safelist.
`PARSING_ERROR`	The operation could not be parsed as GraphQL.
`PERSISTED_QUERY_HASH_MISMATCH`	The operation was not executed due to a mismatch with the automatic persisted query (APQ) protocol. There was an attempt to store this operation in the APQ cache, but the provided hash did not match the operation.
`PERSISTED_QUERY_NOT_FOUND`	The operation was not executed because it was not found in the automatic persisted query (APQ) cache. This is an expected behavior when using the APQ protocol.
`PERSISTED_QUERY_NOT_SUPPORTED`	An operation attempted to use automatic persisted queries, but the feature was not enabled.
`PERSISTED_QUERY_NOT_IN_LIST`	The operation was not executed because it was not found in the persisted query safelist.
`REQUEST_LIMIT_EXCEEDED`	There was an error due to exceeding the max requests configuration for a connector service.
`RESPONSE_VALIDATION_FAILED`	The response returned from a subgraph failed validation for the supergraph schema.
`SUBREQUEST_HTTP_ERROR`	There was an error at the HTTP transport layer when fetching data from a subgraph service.
`UNAUTHORIZED_FIELD_OR_TYPE`	The operation was not fully executed because it attempted to use a field or type was unauthorized.