Skip to content

Internal ​

internalHTTP 500Retrying the same request will not help

Something went wrong inside the server. The details stay in its logs.

Why it happens ​

  • A resolver threw an ordinary exception.
  • A resolver threw a declared error that the operation does not list in throws; the runtime logs it and answers internal.

What to do ​

  • Look at the server's logs for the request. If the failure is part of normal operation, declare it as an error in the schema instead.

What it looks like ​

Inside a batch, the operation's frame carries it:

json
{
  "id": 1,
  "error": {
    "code": "internal",
    "message": "Internal error"
  },
  "fin": true
}

retryable appears only where it differs from the code's default, which is the one at the top of this page.

When the whole request is refused over HTTP, the answer is a problem document:

json
{
  "type": "https://eddyboutros.github.io/rayfold/errors/internal",
  "title": "internal",
  "status": 500,
  "detail": "Internal error",
  "code": "internal"
}

See also all error types and the errors chapter of the specification.

Released under the Apache-2.0 license.