Service Unavailable
service-unavailable · 503
The fallback type for a 503 that has no named type, and no route in the API sends it today.
All pages
A service the API needed being unavailable has a named type, such as auth-unavailable for the identity service.
This type adds no members to the ones every error carries.
- A 503 raised without a type of its own reached the error handler.
- Retry with a growing delay, and don't hammer: a service coming back up is easy to knock over again.
- Tell the user the platform is unavailable, not that their request is wrong.
json
{
"type": "service-unavailable",
"title": "Service Unavailable",
"status": 503,
"detail": "The mail transport refused the message",
"requestId": "req-1785231000000-4f7b2c9ae",
"timestamp": "2026-07-28T09:30:00.000Z",
"path": "/v1/projects",
"method": "GET",
"instance": "GET /v1/projects",
"docs": "https://ghaym.me/docs/errors/service-unavailable"
}