Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13178889.9 KB
labels

Updates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.

post/v2/{+parent}/permissions

Path parameters

parentstring required

Required. The parent label resource name on the label permission is created. Format: labels/{label}.

Query parameters

useAdminAccessboolean

Set to true in order to use the user's admin credentials. The server will verify the user is an admin for the label before allowing access.

Request body

groupstring

Group resource name.

namestring

Resource name of this permission.

emailstring

Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified.

role'LABEL_ROLE_UNSPECIFIED' | 'READER' | 'APPLIER' | 'ORGANIZER' | 'EDITOR'

The role the principal should have.

audiencestring

Audience to grant a role to. The magic value of audiences/default may be used to apply the role to the default audience in the context of the organization that owns the label.

personstring

Person resource name.

Response

Successful response