Skip to navigation

Groups Resource

View as Markdown

The Groups resource provides methods that allow you to manage groups for the account.

Groups can be used to help manage users by associating users with a group. A group can be associated with a Permission Profile, which sets the user permissions for users in that group without having to set the userSettings property for each user. You are not required to set Permission Profiles for a group, but this makes it easier to manage user permissions for a large number of users. Groups can also be used with template sharing to limit user access to templates.

Methods supported

MethodDescription
createPOST /restapi/v2/accounts/{accountId}/groups
Creates one or more groups for the account.
deleteDEL /restapi/v2/accounts/{accountId}/groups
Deletes an existing user group.
listGET /restapi/v2/accounts/{accountId}/groups
Gets information about groups associated with the account.
updatePUT /restapi/v2/accounts/{accountId}/groups
Updates the group information for a group.

Groups properties

PropertyTypeDescription
endPositionstringThe last position in the result set.
groupsarrayA collection group objects containing information about the groups returned.
nextUristringThe URI for the next chunk of records based on the search request. It is null if this is the last set of results for the search.
previousUristringThe URI for the prior chunk of records based on the search request. It is null if this is the first set of results for the search.
resultSetSizestringThe number of results returned in this response.
startPositionstringStarting position of the current result set.
totalSetSizestringThe total number of items in the search’s result set. It will always be greater than or equal to the value of the resultSetSize field.