Out of range

out_of_rangeHTTP 400Retrying the same request will not help

The operation went past the end of what exists, such as reading beyond the last item.

Why it happens

• A request asked for a position, offset or cursor beyond the available data.
• The runtime never sends this code itself, so one you receive came from a resolver or an adapter.

What to do

• Start again from the first page, or stop when a page reports hasMore: false.

What it looks like

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

{
  "id": 1,
  "error": {
    "code": "out_of_range",
    "message": "offset 500 is past the end of the list"
  },
  "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/out_of_range",
  "title": "out of range",
  "status": 400,
  "detail": "offset 500 is past the end of the list",
  "code": "out_of_range"
}

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