BucktDocs

Delete bucket

DELETE/v1/buckets/{id}buckets:deleteSDK: buckets.delete

Marks the bucket for deletion and queues teardown of its S3 bucket, CloudFront distribution, ACM certificate, and DNS records. The response returns immediately with status: "deleting" — the actual cleanup runs in the background.

Path parameters

NameTypeDefaultDescription
idrequiredstring—The bucket ID to delete.

Example request

import { Buckt } from "@buckt/sdk";

const client = new Buckt({ apiKey: process.env.BUCKT_API_KEY });

await client.buckets.delete("bkt_01H8XYZABCDEFGHJKMNPQRSTVW");

Responses

{
  "data": {
    "object": "bucket",
    "id": "bkt_01H8XYZABCDEFGHJKMNPQRSTVW",
    "status": "deleting"
  },
  "error": null,
  "meta": null
}