Not found

not_foundHTTP 404Retrying the same request will not help

What the request names does not exist, or the caller is not allowed to know that it does.

Why it happens

• An id that does not exist, or a path an HTTP binding does not serve.

What to do

• Check the id. Servers often answer not_found rather than permission_denied so they do not reveal what exists.

What it looks like

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

{
  "id": 1,
  "error": {
    "code": "not_found",
    "message": "Order o42 not found"
  },
  "fin": true
}

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

{
  "type": "https://eddyboutros.github.io/rayfold/errors/not_found",
  "title": "not found",
  "status": 404,
  "detail": "Order o42 not found",
  "code": "not_found"
}

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