gateway_timeout

HTTP 504 — An upstream service timed out.

Returned as application/problem+json with code gateway_timeout and HTTP status 504.

An upstream service took too long to respond.

Common causes

  • A slow or unresponsive downstream dependency.

How to resolve

  • Retry with backoff.
  • If it persists, contact support with the request_id.

Example

1{
2 "type": "https://docs.usglobalmail.com/api/problems/gateway_timeout",
3 "title": "An upstream service timed out.",
4 "status": 504,
5 "code": "gateway_timeout",
6 "request_id": "req_8f3c2a1b9d",
7 "instance": "/v1/mails"
8}
This error is typically transient — safe to retry with exponential backoff.