Skip to content

Unknown ​

unknownHTTP 500Retrying the same request will not help

An error came from somewhere that did not say what kind it was.

Why it happens ​

  • Usually a lower layer, such as a library or another service, failed without a usable code.
  • The runtime never sends this code itself, so one you receive came from a resolver or an adapter.

What to do ​

  • Look at the server's logs, and map that failure to a specific code where it is caught.

What it looks like ​

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

json
{
  "id": 1,
  "error": {
    "code": "unknown",
    "message": "Unknown 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/unknown",
  "title": "unknown",
  "status": 500,
  "detail": "Unknown error",
  "code": "unknown"
}

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

Released under the Apache-2.0 license.