Skip to content

Canceled ​

canceledHTTP 499Retrying the same request will not help

The caller stopped the request before it finished.

Why it happens ​

  • The client aborted, closed the connection, or navigated away.

What to do ​

  • Nothing to fix on the server. A command that was canceled can be sent again with the same idempotency key.

What it looks like ​

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

json
{
  "id": 1,
  "error": {
    "code": "canceled",
    "message": "Canceled"
  },
  "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:

json
{
  "type": "https://eddyboutros.github.io/rayfold/errors/canceled",
  "title": "canceled",
  "status": 499,
  "detail": "Canceled",
  "code": "canceled"
}

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

Released under the Apache-2.0 license.