Resource: UserRole
Contains properties of auser role, which is used to manage user access.
JSON representation | |
---|---|
{
"id": string,
"name": string,
"accountId": string,
"subaccountId": string,
"parentUserRoleId": string,
"permissions": [
{
object ( |
Fields | |
---|---|
id |
ID of this user role. This is a read-only, auto-generated field. |
name |
Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account. |
accountId |
Account ID of this user role. This is a read-only field that can be left blank. |
subaccountId |
Subaccount ID of this user role. This is a read-only field that can be left blank. |
parentUserRoleId |
ID of the user role that this user role is based on or copied from. This is a required field. |
permissions[] |
accountPermissionGroups.list of permissions associated with this user role. |
defaultUserRole |
Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions. |
kind |
Identifies what kind of resource this is. Value: the fixed string
. |
Methods |
|
---|---|
|
Deletes an existing user role. |
|
Gets one user role by ID. |
|
Inserts a new user role. |
|
Retrieves a list of user roles, possibly filtered. |
|
Updates an existing user role. |
|
Updates an existing user role. |