Region Briefly Full

region-briefly-full · 503

The region had no room to wake the service at that moment, so the API left it asleep and stopped nothing to make room.

projected is what the region's hosts would hold with the service awake, reserved what they hold now and totalValue what they have, in unit. retryable is always true: room comes back as other services fall asleep. Production never sleeps, so it never meets this.

Besides the members every error carries, this type adds regionSlug, unit, totalValue, reserved, projected and retryable.

Common causes

  • Starting the service, opening a tunnel with --wake, or taking a backup of a sleeping database found the region full.
  • Many services in the region woke at about the same time.

How to fix the call

  • Retry after a short wait: this is one of the errors where retrying unchanged is right.
  • If it lasts, tell the user: Ghaym's operators are told at the same moment, since the region needs more room.

Example response

json
{
  "type": "region-briefly-full",
  "title": "Region Briefly Full",
  "detail": "Region 'amman-1' is briefly full — waking this service needs 66 GB of RAM against 64. Nothing was stopped to make room; retry in a moment.",
  "regionSlug": "amman-1",
  "unit": "ram-gb",
  "totalValue": 64,
  "reserved": 62,
  "projected": 66,
  "retryable": true,
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/start",
  "status": 503,
  "docs": "https://ghaym.me/docs/errors/region-briefly-full"
}