View Source DocuSign.Api.Groups (DocuSign v1.2.0)
API calls for all endpoints tagged Groups.
Summary
Functions
Deletes an existing user group.
Deletes an existing user group. When you delete a group, you include only the groupId in the request body. Example: { "groups": [ { "groupId": "12345" } }
Gets information about groups associated with the account. Retrieves information about groups associated with the account. Note: To retrieve a group's users, use this endpoint to get the group ID and then call the listGroupUsers endpoint. ### Related topics - How to set a permission profile
Creates one or more groups for the account.
Creates one or more groups for the account. Groups can be used to help manage users by associating users with a group. You can associate a group 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 it makes it easier to manage user permissions for a large number of users. You can also use groups with template sharing to limit user access to templates.
Updates the group information for a group. Updates the group name and modifies, or sets, the permission profile for the group. ### Related topics - How-To Set Up a Permission Profile
Functions
@spec groups_delete_groups(Tesla.Env.client(), String.t(), keyword()) :: {:ok, DocuSign.Model.ErrorDetails.t()} | {:ok, DocuSign.Model.GroupInformation.t()} | {:error, Tesla.Env.t()}
Deletes an existing user group.
Deletes an existing user group. When you delete a group, you include only the groupId in the request body. Example: { "groups": [ { "groupId": "12345" } }
Parameters
connection(DocuSign.Connection): Connection to serveraccount_id(String.t): The external account number (int) or account ID GUID.opts(keyword): Optional parameters:body(GroupInformation):
Returns
{:ok, DocuSign.Model.GroupInformation.t}on success{:error, Tesla.Env.t}on failure
@spec groups_get_groups(Tesla.Env.client(), String.t(), keyword()) :: {:ok, DocuSign.Model.ErrorDetails.t()} | {:ok, DocuSign.Model.GroupInformation.t()} | {:error, Tesla.Env.t()}
Gets information about groups associated with the account. Retrieves information about groups associated with the account. Note: To retrieve a group's users, use this endpoint to get the group ID and then call the listGroupUsers endpoint. ### Related topics - How to set a permission profile
Parameters
connection(DocuSign.Connection): Connection to serveraccount_id(String.t): The external account number (int) or account ID GUID.opts(keyword): Optional parameters:count(String.t): The maximum number of results to return. Usestart_positionto specify the number of results to skip. Valid values:1to100:group_type(String.t): The type of group to return. Valid values:AdminGroupCustomGroup*EveryoneGroup:include_usercount(String.t): When true, every group returned in the response includes auserCountproperty that contains the total number of users in the group. The default is true.:search_text(String.t): Filters the results of a GET request based on the text that you specify.:start_position(String.t): The zero-based index of the result from which to start returning results. Use withcountto limit the number of results. The default value is0.
Returns
{:ok, DocuSign.Model.GroupInformation.t}on success{:error, Tesla.Env.t}on failure
@spec groups_post_groups(Tesla.Env.client(), String.t(), keyword()) :: {:ok, DocuSign.Model.ErrorDetails.t()} | {:ok, DocuSign.Model.GroupInformation.t()} | {:error, Tesla.Env.t()}
Creates one or more groups for the account.
Creates one or more groups for the account. Groups can be used to help manage users by associating users with a group. You can associate a group 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 it makes it easier to manage user permissions for a large number of users. You can also use groups with template sharing to limit user access to templates.
Parameters
connection(DocuSign.Connection): Connection to serveraccount_id(String.t): The external account number (int) or account ID GUID.opts(keyword): Optional parameters:body(GroupInformation):
Returns
{:ok, DocuSign.Model.GroupInformation.t}on success{:error, Tesla.Env.t}on failure
@spec groups_put_groups(Tesla.Env.client(), String.t(), keyword()) :: {:ok, DocuSign.Model.ErrorDetails.t()} | {:ok, DocuSign.Model.GroupInformation.t()} | {:error, Tesla.Env.t()}
Updates the group information for a group. Updates the group name and modifies, or sets, the permission profile for the group. ### Related topics - How-To Set Up a Permission Profile
Parameters
connection(DocuSign.Connection): Connection to serveraccount_id(String.t): The external account number (int) or account ID GUID.opts(keyword): Optional parameters:body(GroupInformation):
Returns
{:ok, DocuSign.Model.GroupInformation.t}on success{:error, Tesla.Env.t}on failure