Gateway timeout

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.

Check system status

A 504 is a server-side failure, so it may reflect a known incident rather than a problem with your request. Check the System status page — if there’s an open incident affecting the USGM API or USGM Core, the issue is on our side, so wait for it to resolve. If everything is operational and the error persists, contact support with your 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
}