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
}

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:

{
  "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.