Database Suspended

database-suspended · 402

The database is suspended, so the API opened no tunnel to it.

reason says why: payment_failed, usage_limit, exposure_ceiling or abuse, or null when none was recorded. The CLI exits with code 7.

Besides the members every error carries, this type adds service, environment and reason.

Common causes

  • A payment failed and the account was suspended: payment_failed.
  • The account reached the usage limit it set itself: usage_limit.
  • An operator put the database or the account on hold: abuse.

How to fix the call

  • With payment_failed, the account's billing needs settling; with usage_limit, the limit needs raising. Both are the user's decisions.
  • With abuse, only support lifts the hold.
  • Don't retry until the hold is lifted: the answer won't change.

Example response

json
{
  "type": "database-suspended",
  "title": "Database Suspended",
  "detail": "orders-db is suspended in staging.",
  "service": "orders-db",
  "environment": "staging",
  "reason": "payment_failed",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "status": 402,
  "docs": "https://ghaym.me/docs/errors/database-suspended"
}