Docs
Launch GraphOS Studio

Errors

Error and status codes returned by the Apollo Router


Learn about error codes and HTTP response status codes returned by the .

Status codes

CodeDescription
400
Bad request

A request failed 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 endpoint calling a subscription callback URL, the couldn't find a matching subscription identifier between its registered subscriptions and a subscription event.
405
Method not allowed

A request used an unallowed HTTP method.

NOTE

Both and 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.

Previous
Entity caching
Next
Telemetry
Edit on GitHubEditForumsDiscord

Company