Account Suspended

account-suspended · 402

The account is suspended, so the API won't launch or deploy anything on it until the suspension is lifted.

reason says why, and so what lifts it. Only payment_failed counts down retentionDaysRemaining, the days left before the account's data is deleted; usage_limit and abuse delete nothing.

Besides the members every error carries, this type adds reason, currency, retentionDaysRemaining and billingUrl.

Common causes

  • A payment failed and wasn't recovered (payment_failed).
  • The month's usage reached the usage limit the account set (usage_limit).
  • An operator took the account down for abuse (abuse).

How to fix the call

  • For payment_failed, tell the user to update the card at billingUrl before the days run out.
  • For usage_limit, the organization's owner or one of its admins raises or clears the limit with PUT /v1/billing/account/usage-limit.
  • For abuse, tell the user to contact support.
  • Read what stands in the way with ghaym cloud billing eligibility, or GET /v1/billing/eligibility, before trying again.

Example response

json
{
  "type": "account-suspended",
  "title": "Account Suspended",
  "detail": "This account is suspended (payment_failed): a payment failed and was not recovered. Update the card on file at https://auth.ghaym.me/account/billing to resume it. Its data is kept for 23 more day(s). Read the current state from GET /v1/billing/eligibility.",
  "reason": "payment_failed",
  "currency": null,
  "retentionDaysRemaining": 23,
  "billingUrl": "https://auth.ghaym.me/account/billing",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/deployments",
  "status": 402,
  "docs": "https://ghaym.me/docs/errors/account-suspended"
}