Bucket Suspended

bucket-suspended · 409

The bucket is on hold, so the API refused anything that uses its key or could undo the hold.

reason is abuse when an operator took the bucket down, or account when the account is suspended and the bucket's key went with it. Listing buckets and reading this one still work, so its suspension shows.

Besides the members every error carries, this type adds code, bucketId and reason.

Common causes

  • An operator put the bucket on hold after an abuse report.
  • The account is suspended, so every bucket's key was revoked.
  • The call read or rotated the key, changed the settings, deleted the bucket, uploaded, or listed or linked its files while the hold lasted.

How to fix the call

  • Don't retry, and don't try another route: each one makes the same check.
  • With account, the hold lifts when the account's does: settling a failed payment, raising a reached usage limit, or support lifting an abuse hold.
  • With abuse, only support lifts the hold: tell the user to contact support.

Example response

json
{
  "type": "bucket-suspended",
  "title": "Bucket Suspended",
  "detail": "Bucket '0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401' is suspended for 'abuse' and cannot be used until the hold is lifted",
  "code": "BUCKET_SUSPENDED",
  "bucketId": "0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401",
  "reason": "abuse",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials",
  "method": "GET",
  "instance": "GET /v1/buckets/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/credentials",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-suspended"
}