Bucket Name Taken

bucket-name-taken · 409

Another bucket already has this name, so the API created no bucket.

The store keeps one name per bucket across every site and every workspace, not only this one.

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

Common causes

  • A bucket in any workspace and any site already uses the name.
  • Two creates with the same name raced, and the other one won.

How to fix the call

  • Pick another name and create the bucket again.
  • Don't retry with the same name: it stays taken while that bucket exists.

Example response

json
{
  "type": "bucket-name-taken",
  "title": "Bucket Name Taken",
  "detail": "Bucket name 'assets' is already taken",
  "code": "BUCKET_NAME_TAKEN",
  "name": "assets",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/buckets",
  "method": "POST",
  "instance": "POST /v1/buckets",
  "status": 409,
  "docs": "https://ghaym.me/docs/errors/bucket-name-taken"
}