Gateway Timeout

URI: https://docs.ankatech.co/errors/gateway-timeout
HTTP Status: 504 Gateway Timeout

When you see this

An upstream dependency the audit service called did not respond within the operation's deadline. The request is retryable.

Common Causes

An upstream query or aggregation exceeding its deadline.
Temporary slowness in a downstream data source.
Network latency between the audit service and its dependency.

Response Example

{
  "type": "https://docs.ankatech.co/errors/gateway-timeout",
  "title": "Gateway Timeout",
  "status": 504,
  "detail": "An upstream dependency did not respond within the deadline.",
  "instance": "/api/v3/audit/correlation/00000000-0000-0000-0000-000000000099",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

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

How to Resolve

Retry the request — gateway timeouts are typically transient.
Honor the Retry-After header when present, otherwise apply exponential backoff.
Narrow the query scope to reduce upstream work, and contact support if timeouts persist.

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