timeout

HTTP 504Gateway Timeout

An upstream dependency did not respond in time.

The request was accepted and may have been partially processed. Treat it as indeterminate rather than as a definite failure.

Response shape

{
  "type": "https://api-docs.ahoy.ai/rest/v1/errors/timeout",
  "title": "Gateway Timeout",
  "status": 504,
  "detail": "The upstream request did not complete within the time limit.",
  "code": "timeout",
  "request_id": "req_01J8Z2K9QW3X4Y5Z6A7B8C9D"
}

This code is not further sub-classified — it never carries a reason member.

How to resolve it

• Retry with backoff.
• For writes, prefer idempotent operations — a PUT upsert replayed with the same body is safe, and a write whose values already match is treated as a success.
• If a query times out repeatedly, narrow the filter or reduce the page size.