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.

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.

Common causes

  • Services used as much this month as the limit allows.
  • The limit was lowered below what the month had already used.

How to fix the call

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

Example response

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