service_unavailable

A dependency the API needs to process your request safely is temporarily unavailable. The request was not processed — nothing was created or changed.

Example response

HTTP/1.1 503 Service Unavailable
Content-Type: application/problem+json
X-Request-ID: 7d1e9c2a-3b4f-4c5d-8e6f-9a0b1c2d3e4f

{
  "type": "https://docs.talero.dk/problems/service_unavailable",
  "title": "Service unavailable",
  "status": 503,
  "detail": "Rate limiting is temporarily unavailable: connection refused.",
  "code": "service_unavailable"
}

Common causes

• A backing service (for example the shared rate-limit store) is briefly unreachable.
• A deployment or infrastructure failover is in progress.

How to fix it

• Retry with exponential backoff — these conditions usually clear within seconds to minutes.
• Reuse the same Idempotency-Key when retrying creates, so the retry can never duplicate work — see Idempotency.
• If the condition lasts more than a few minutes, contact [email protected] with an X-Request-ID.

If the problem persists, contact [email protected] and quote the X-Request-ID header from the failing response.