Buckets: delete

Requires authorization

Permanently deletes an empty bucket. Try it now.

The authenticated user must have sufficient permission to use this method.

Request

HTTP request

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

Parameters

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.

Authorization

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

Scope
https://www.googleapis.com/auth/devstorage.full_control
https://www.googleapis.com/auth/devstorage.read_write
https://www.googleapis.com/auth/cloud-platform

Request body

Do not supply a request body with this method.

Response

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.