---
title: "POST /b/{bucket}/defaultObjectAcl"
method: POST
path: "/b/{bucket}/defaultObjectAcl"
tags: ["defaultObjectAccessControls"]
---

# POST /b/{bucket}/defaultObjectAcl

`POST /b/{bucket}/defaultObjectAcl`

Creates a new default object ACL entry on the specified bucket.

## Path parameters

- `bucket` string, required

## Query parameters

- `userProject` string

## Request body

- ObjectAccessControl — An access-control entry.
  - `bucket` string — The name of the bucket.
  - `domain` string — The domain associated with the entity, if any.
  - `email` string — The email address associated with the entity, if any.
  - `entity` string — The entity holding the permission, in one of the following forms: - user-userId - user-email - group-groupId - group-email - domain-domain - project-team-projectId - allUsers - allAuthenticatedUsers Examples: - The user liz@example.com would be user-liz@example.com. - The group example@googlegroups.com would be group-example@googlegroups.com. - To refer to all members of the Google Apps for Business domain example.com, the entity would be domain-example.com.
  - `entityId` string — The ID for the entity, if any.
  - `etag` string — HTTP 1.1 Entity tag for the access-control entry.
  - `generation` string, int64 — The content generation of the object, if applied to an object.
  - `id` string — The ID of the access-control entry.
  - `kind` string — The kind of item this is. For object access control entries, this is always storage#objectAccessControl.
  - `object` string — The name of the object, if applied to an object.
  - `projectTeam` object — The project team associated with the entity, if any.
    - `projectNumber` string — The project number.
    - `team` string — The team.
  - `role` string — The access permission for the entity.
  - `selfLink` string — The link to this access-control entry.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/storage.md) · [All operations](https://skmtc.dev/google/apis/storage/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/storage/revisions/4623cd2c71cf/schema)
