API

upstream_error

HTTP 502. Upstream error

What it means

A connector or a chain RPC failed.

What to do

Retry with backoff. Planning and discovery degrade instead of failing when only some sources are down; sources in the plan says which.

Retrying

Retry with backoff. The SDKs do this for you.

Extra members

retry_after: Seconds to wait before retrying.

Example

json

{
  "type": "https://reuseforge.com/docs/api/errors/upstream_error",
  "title": "Upstream error",
  "status": 502,
  "detail": "An upstream source did not answer.",
  "instance": "/api/v1/items/acme/invoice-extractor",
  "code": "upstream_error",
  "request_id": "req_c4v8n2m6x1z3",
  "retry_after": 5
}

Every error is application/problem+json (RFC 9457). Branch on code, show detail to people and quote request_id when you ask for help. See the error catalogue.