Bucket Suspended
bucket-suspended · 409
The bucket is on hold, so the API refused anything that uses its key or could undo the hold.
All pages
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.
- 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.
- 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.
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"
}