Unavailable

unavailableHTTP 503Worth retrying

The server or something it depends on is down for the moment.

Why it happens

• The service is restarting, overloaded, or cannot reach its database.

What to do

• Try again after a short wait, backing off between attempts. Commands keep their idempotency key, so they never run twice.

What it looks like

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

{
  "id": 1,
  "error": {
    "code": "unavailable",
    "message": "Database unavailable",
    "retryable": true
  },
  "fin": true
}

When the whole request is refused over HTTP, the answer is a problem document:

{
  "type": "https://eddyboutros.github.io/rayfold/errors/unavailable",
  "title": "unavailable",
  "status": 503,
  "detail": "Database unavailable",
  "code": "unavailable"
}

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