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.

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
}

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.