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.