User Permissions

For a list of methods for this resource, see the end of this page.

Resource representations

Represents a user's permissions to an account and its container.

{
  "path": string,
  "accountId": string,
  "emailAddress": string,
  "accountAccess": {
    "permission": string
  },
  "containerAccess": [
    {
      "containerId": string,
      "permission": string
    }
  ]
}

Property name	Value	Description	Notes
accountAccess	nested object	GTM Account access permissions.
accountAccess.permission	string	Whether the user has no access, user access, or admin access to an account. Acceptable values are: "accountPermissionUnspecified" "admin" "noAccess" "user"
accountId	string	The Account ID uniquely identifies the GTM Account.
containerAccess[]	list	GTM Container access permissions.
containerAccess[].containerId	string	GTM Container ID.
containerAccess[].permission	string	List of Container permissions. Acceptable values are: "approve" "containerPermissionUnspecified" "edit" "noAccess" "publish" "read"
emailAddress	string	User's email address.
path	string	GTM UserPermission's API relative path.

Methods

create

Creates a user's Account & Container access.

delete

Removes a user from the account, revoking access to it and all of its containers.

get

Gets a user's Account & Container access.

list

List all users that have access to the account along with Account and Container user access granted to each of them.

update

Updates a user's Account & Container access.