Usage Limit Exceeded
usage-limit-exceeded · 402
This month's usage has reached the usage limit the account set itself, so the API started nothing new.
All pages
It refuses a launch, a deploy, a start and a wake, ghaym cloud connect --wake included. It also refuses what adds capacity with no deploy: a new environment in a project that has a database, a published changeset that adds a database copy or raises replicas or readers, a database resize to more memory, and a provisioning retry. It isn't the limit billing sets, the exposure ceiling. The amounts are strings in currency, with that currency's decimals: three for JOD, two for SAR.
Besides the members every error carries, this type adds currency, usageJod and usageLimitJod.
- Services used as much this month as the limit allows.
- The limit was lowered below what the month had already used.
- Tell the user: the organization's owner or one of its admins raises or clears the limit with
PUT /v1/billing/account/usage-limit. - Or wait for the next month, when usage starts again from zero.
- Don't retry before then: the answer won't change.
json
{
"type": "usage-limit-exceeded",
"title": "Usage Limit Exceeded",
"detail": "This month's usage (40.000 JOD) has reached the 40.000 JOD usage limit set on this account. Raise or clear it with PUT /v1/billing/account/usage-limit.",
"currency": "JOD",
"usageJod": "40.000",
"usageLimitJod": "40.000",
"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": 402,
"docs": "https://ghaym.me/docs/errors/usage-limit-exceeded"
}