How do I delete a bucket with the API?

Before you delete, download anything you want to keep: there's no published way to undo a deletion.

curl -X DELETE https://api.codebuckets.clatterlabs.xyz/v1/buckets/BUCKET_ID \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"

The response is { "object": "bucket", "id": "cbk_…", "deleted": true }. The bucket disappears from the project and the API and stops counting toward your usage. A bucket.deleted event is recorded in the project's feed.

In the Console, use the bucket's Settings › Danger zone.

Learn more#

• Concepts
• Create a bucket