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.

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.

Common causes

  • A 503 raised without a type of its own reached the error handler.

How to fix the call

  • 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.

Example response

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"
}