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.

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
}

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.