upstream_unavailable

Upstream unavailable

Code: upstream_unavailable · HTTP status: usually 503

A service the answer depends on did not respond in time.

How to fix

Retry with exponential backoff. Reads are safe to repeat; for a write, read the resource first.

Example response

{
  "code": "upstream_unavailable",
  "type": "https://docs.stoqapp.com/v2/docs/api-v2/errors/upstream-unavailable/",
  "title": "Upstream unavailable",
  "status": 503,
  "detail": "Upstream unavailable. A service this answer depends on did not respond. Retry with backoff.",
  "errors": [
    "Upstream unavailable"
  ],
  "details": [
    {
      "code": "upstream_unavailable",
      "message": "Upstream unavailable",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}

Every API v2 and MCP failure carries code and a type link to its page here. See Errors & Responses for the full envelope.