Role Management API
The Roles Management API provides a consistent way to assign and revoke access control roles across users and groups within your organization. Use these endpoints to manage key roles like viewer, manager, or owner for individuals or teams.
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rolestring · enumRequiredPossible values:
emailstring · emailRequired
Body
anyOptional
Responses
204
Role assigned
400
Bad request
401
Unauthorized
put
/{role}/bindings/users/{email}No content
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rolestring · enumRequiredPossible values:
emailstring · emailRequired
Responses
204
Role removed
400
Bad request
401
Unauthorized
delete
/{role}/bindings/users/{email}No content
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rolestring · enumRequiredPossible values:
groupstringRequired
Responses
201
Group role unchanged
204
Role assigned to group
400
Bad request
401
Unauthorized
put
/{role}/bindings/groups/{group}No content
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
rolestring · enumRequiredPossible values:
groupstringRequired
Responses
204
Group role removed
400
Bad request
401
Unauthorized
delete
/{role}/bindings/groups/{group}No content
Last updated