Buckets: delete

Requires authorization

Permanently deletes an empty bucket. Try it now.

The authenticated user must be a member of the project's team as an editor or owner. 


HTTP request

DELETE https://www.googleapis.com/storage/v1/b/bucket


Parameter name Value Description
Path parameters
bucket string Name of a bucket.
Optional query parameters
ifMetagenerationMatch long If set, only deletes the bucket if its metageneration matches this value.
ifMetagenerationNotMatch long If set, only deletes the bucket if its metageneration does not match this value.
userProject string The project to be billed for this request. Required for Requester Pays buckets.


This request requires authorization with at least one of the following scopes (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns an empty response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Storage
Need help? Visit our support page.