Data Source Unavailable

URI: https://docs.ankatech.co/errors/data-source-unavailable
HTTP Status: 503 Service Unavailable

When you see this

A data source the service depends on (such as the database or cache) is temporarily unreachable, so the request cannot be served right now.

Common Causes

The database or cache is down, restarting, or undergoing maintenance.
A network partition between the service and its data source.
Connection-pool exhaustion preventing new data-source connections.

Response Example

{
  "type": "https://docs.ankatech.co/errors/data-source-unavailable",
  "title": "Data Source Unavailable",
  "status": 503,
  "detail": "A required data source is temporarily unavailable. Please retry shortly.",
  "instance": "/api/v3/keys",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

Content-Type: application/problem+json — the response follows RFC 7807 Problem Details.

How to Resolve

Wait briefly and retry — this condition is typically transient.
Honor the Retry-After header when present, otherwise apply exponential backoff.
If the data source remains unavailable for an extended period, contact support with the correlationId.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.