ObjectAccessControls: delete
Permanently deletes the ACL entry for the specified entity on the specifiedobject.
Important: This method fails with a400 Bad Request response for buckets with uniform bucket-level access enabled. Usestorage.buckets.getIamPolicy andstorage.buckets.setIamPolicy to control access instead.You cannot removeOWNER access from the owner of this object using this method; theonly way to remove that access is to delete or replace the object.
Required permissions
The authenticated user must have one of the following permissions to use this method:
- The
storage.objects.setIamPolicyIAM permission for the bucketcontaining the object - The
OWNERACL permission for the object
Request
HTTP request
DELETE https://storage.googleapis.com/storage/v1/b/bucket/o/object/acl/entity
In addition tostandard query parameters, the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see theJSON API Overview page.
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket | string | Name of a bucket. |
entity | string | The entity holding the permission. Can beuser-emailAddress,group-groupId,group-emailAddress,allUsers, orallAuthenticatedUsers. |
object | string | Name of the object. For information about how to URL encode object names to be path safe, seeEncoding URI path parts. |
| Optional query parameters | ||
generation | long | If present, selects a specific revision of this object (as opposed to the latest version, the default). |
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.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.