Skip to content
Last updated

Gateway Timeout

HTTP Status: 504 Gateway Timeout
RFC Reference: RFC 9110 Section 15.6.5

A required downstream service did not respond in time.

Response

HTTP/1.1 504 Gateway Timeout
Content-Type: application/problem+json
Retry-After: 60

{
  "type": "https://docs.apiera.io/problems/gateway-timeout",
  "title": "Gateway Timeout",
  "status": 504,
  "detail": "A required downstream service did not respond in time. Please try again later.",
  "instance": "/v1/products",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000"
}

How to Handle

  1. Check the Retry-After header (60 seconds)
  2. Wait before retrying
  3. Implement exponential backoff for multiple failures

This is typically a temporary issue. If it persists, contact support with the correlationId.