--- title: Delete Bucket --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [R2](https://developers.cloudflare.com/api/go/resources/r2) [Buckets](https://developers.cloudflare.com/api/go/resources/r2/subresources/buckets) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Delete Bucket client.R2.Buckets.Delete(ctx, bucketName, params) (\*[BucketDeleteResponse](), error) DELETE/accounts/{account\_id}/r2/buckets/{bucket\_name} Deletes an empty R2 bucket and its configuration. The bucket must have no objects, no in-progress multipart uploads, and no event notification rules; otherwise the request fails. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Workers R2 Storage Write` ##### ParametersExpand Collapse bucketName string Name of the bucket. maxLength64 minLength3 [Link to this property](<#(resource)%20r2.buckets%20%3E%20(method)%20delete%20%3E%20(params)%20default%20%3E%20(param)%20bucket_name%20%3E%20(schema)>)

params BucketDeleteParams

AccountID param.Field\[string] Path param: Cloudflare account ID that owns the R2 resource. maxLength32 Link to this property

CfR2Jurisdiction param.Field\[BucketDeleteParamsCfR2Jurisdiction]Optional Header param: Jurisdiction where objects in this bucket are guaranteed to be stored.

const BucketDeleteParamsCfR2JurisdictionDefault BucketDeleteParamsCfR2Jurisdiction = "default" Link to this property const BucketDeleteParamsCfR2JurisdictionEu BucketDeleteParamsCfR2Jurisdiction = "eu" Link to this property const BucketDeleteParamsCfR2JurisdictionUs BucketDeleteParamsCfR2Jurisdiction = "us" Link to this property const BucketDeleteParamsCfR2JurisdictionFedramp BucketDeleteParamsCfR2Jurisdiction = "fedramp" Link to this property const BucketDeleteParamsCfR2JurisdictionFedrampHigh BucketDeleteParamsCfR2Jurisdiction = "fedramp-high" Link to this property

Link to this property

[Link to this property](<#(resource)%20r2.buckets%20%3E%20(method)%20delete%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse type BucketDeleteResponse interface{…} [Link to this property](<#(resource)%20r2.buckets%20%3E%20(model)%20BucketDeleteResponse%20%3E%20(schema)>) ### Delete Bucket Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/r2" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) bucket, err := client.R2.Buckets.Delete( context.TODO(), "example-bucket", r2.BucketDeleteParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", bucket) } ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": {}, "success": true } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ "string" ], "result": {}, "success": true } ```