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": "Request canceled by the client"
  },
  "fin": true
}

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": "Request canceled by the client",
  "code": "canceled"
}

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

Released under the Apache-2.0 license.