Skip to content

Deadline exceeded

deadline_exceededHTTP 504Worth retrying

The request's deadline passed before the server finished.

Why it happens

  • The deadline sent with the request was shorter than the work took.

What to do

  • Give the request more time (at most 600000 ms), or ask for less. The server stops work for a request once its deadline passes.

What it looks like

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

json
{
  "id": 1,
  "error": {
    "code": "deadline_exceeded",
    "message": "Deadline of 200 ms exceeded",
    "retryable": true
  },
  "fin": true
}

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

json
{
  "type": "https://eddyboutros.github.io/rayfold/errors/deadline_exceeded",
  "title": "deadline exceeded",
  "status": 504,
  "detail": "Deadline of 200 ms exceeded",
  "code": "deadline_exceeded"
}

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

Released under the Apache-2.0 license.