Accounts: updateSharedAccess

Reserved: Sets the shared access information for one or more users.

Request

HTTP request

PUT /v2/accounts/{accountId}/shared_access

Parameters

Parameter name Value Description
Path parameters
accountId string

The external account number (int) or account ID Guid.

Optional query parameters
item_type string
user_ids string

Request Body

Responses

Code Description Reference
200 OK Successful response.
400 Bad Request Error encountered.

SDK Method

Accounts::updateSharedAccess

Definitions Expand All | Collapse All

accountSharedAccess

Contains shared access information.

accountId string

The account ID associated with the envelope.

endPosition string

The last position in the result set.

errorDetails errorDetails

A complex type containing an errorCode and message identifying the error that occurred.

nextUri string

The 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.

previousUri string

The 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.

resultSetSize string

The number of results returned in this response.

sharedAccess
[memberSharedItems]

A complex type containing the shared access information to an envelope for the users specified in the request.

startPosition string

Starting position of the current result set.

totalSetSize string

The 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.

errorDetails

This object describes errors that occur. It is only valid for responses, and ignored in requests.

errorCode string

An error code associated with the error.

message string

A short error message.

group

errorDetails errorDetails
groupId string

The DocuSign group ID for the group.

groupName string

The name of the group. The search_text provided in the call automatically performs a wild card search on group_name.

groupType string

The group type.

permissionProfileId string

The ID of the permission profile associated with the group.

users
[userInfo]

memberGroupSharedItem

errorDetails errorDetails
group group
shared string

When set to true, this custom tab is shared.

memberSharedItems

envelopes
[sharedItem]
errorDetails errorDetails
templates
[templateSharedItem]
user userInfo

sharedItem

errorDetails errorDetails
shared string

When set to true, this custom tab is shared.

user userInfo

templateSharedItem

errorDetails errorDetails
owner userInfo
shared string

When set to true, this custom tab is shared.

sharedGroups
[memberGroupSharedItem]
sharedUsers
[userSharedItem]
templateId string

The unique identifier of the template. If this is not provided, DocuSign will generate a value.

templateName string

userInfo

activationAccessCode string
email string
errorDetails errorDetails
loginStatus string
sendActivationEmail string
uri string
userId string

The user ID of the user being accessed. Generally this is the user ID of the authenticated user, but if the authenticated user is an Admin on the account, this may be another user the Admin user is accessing.

userName string
userStatus string

Status of the user's account. One of:

  • ActivationRequired
  • ActivationSent
  • Active
  • Closed
  • Disabled
userType string

userSharedItem

errorDetails errorDetails
shared string

When set to true, this custom tab is shared.

user userInfo

Examples

Generic JSON Request/Response

Request

{
"resultSetSize": "sample string 1",
"totalSetSize": "sample string 2",
"startPosition": "sample string 3",
"endPosition": "sample string 4",
"nextUri": "sample string 5",
"previousUri": "sample string 6",
"accountId": "sample string 7",
"sharedAccess": [
{
"user": {
"userName": "sample string 1",
"userId": "sample string 2",
"email": "sample string 3",
"userType": "sample string 4",
"userStatus": "sample string 5",
"uri": "sample string 6",
"loginStatus": "sample string 7",
"sendActivationEmail": "sample string 8",
"activationAccessCode": "sample string 9"
}
,
"envelopes": [
{
"user": {},
"shared": "sample string 1"
}
]
,
"templates": [
{
"templateId": "sample string 1",
"templateName": "sample string 2",
"owner": {},
"sharedUsers": [
{
"user": {}
}
]
,
"sharedGroups": [
{
"group": {
"groupId": "sample string 1",
"groupName": "sample string 2",
"permissionProfileId": "sample string 3",
"groupType": "sample string 4",
"users": [
{}
]
}
}
]
,
"shared": "sample string 3"
}
]
}
]
}

Response

{
"resultSetSize": "sample string 1",
"totalSetSize": "sample string 2",
"startPosition": "sample string 3",
"endPosition": "sample string 4",
"nextUri": "sample string 5",
"previousUri": "sample string 6",
"accountId": "sample string 7",
"sharedAccess": [
{
"user": {
"userName": "sample string 1",
"userId": "sample string 2",
"email": "sample string 3",
"userType": "sample string 4",
"userStatus": "sample string 5",
"uri": "sample string 6",
"loginStatus": "sample string 7",
"sendActivationEmail": "sample string 8",
"activationAccessCode": "sample string 9",
"errorDetails": {
"errorCode": "sample string 1",
"message": "sample string 2"
}
}
,
"envelopes": [
{
"user": {},
"shared": "sample string 1",
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
}
]
,
"templates": [
{
"templateId": "sample string 1",
"templateName": "sample string 2",
"owner": {},
"sharedUsers": [
{
"user": {},
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
,
"shared": "sample string 1"
}
]
,
"sharedGroups": [
{
"group": {
"groupId": "sample string 1",
"groupName": "sample string 2",
"permissionProfileId": "sample string 3",
"groupType": "sample string 4",
"users": [
{}
]
,
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
}
,
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
,
"shared": "sample string 1"
}
]
,
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
}
]
,
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
}
]
,
"errorDetails": {
"errorCode": "SUCCESS",
"message": ""
}
}

Generic XML Request/Response

Request

<accountSharedAccess 
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.docusign.com/restapi">

<accountId>sample string 7</accountId>
<endPosition>sample string 4</endPosition>
<nextUri>sample string 5</nextUri>
<previousUri>sample string 6</previousUri>
<resultSetSize>sample string 1</resultSetSize>
<sharedAccess>
<memberSharedItems>
<envelopes>
<sharedItem>
<shared>sample string 1</shared>
<user />
</sharedItem>
</envelopes>
<templates>
<templateSharedItem>
<owner />
<shared>sample string 3</shared>
<sharedGroups>
<memberGroupSharedItem>
<group>
<groupId>sample string 1</groupId>
<groupName>sample string 2</groupName>
<groupType>sample string 4</groupType>
<permissionProfileId>sample string 3</permissionProfileId>
<users>
<userInfo />
</users>
</group>
</memberGroupSharedItem>
</sharedGroups>
<sharedUsers>
<userSharedItem>
<user />
</userSharedItem>
</sharedUsers>
<templateId>sample string 1</templateId>
<templateName>sample string 2</templateName>
</templateSharedItem>
</templates>
<user>
<activationAccessCode>sample string 9</activationAccessCode>
<email>sample string 3</email>
<loginStatus>sample string 7</loginStatus>
<sendActivationEmail>sample string 8</sendActivationEmail>
<uri>sample string 6</uri>
<userId>sample string 2</userId>
<userName>sample string 1</userName>
<userStatus>sample string 5</userStatus>
<userType>sample string 4</userType>
</user>
</memberSharedItems>
</sharedAccess>
<startPosition>sample string 3</startPosition>
<totalSetSize>sample string 2</totalSetSize>
</accountSharedAccess>

Response

<accountSharedAccess 
xmlns:i="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.docusign.com/restapi">

<accountId>sample string 7</accountId>
<endPosition>sample string 4</endPosition>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<nextUri>sample string 5</nextUri>
<previousUri>sample string 6</previousUri>
<resultSetSize>sample string 1</resultSetSize>
<sharedAccess>
<memberSharedItems>
<envelopes>
<sharedItem>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<shared>sample string 1</shared>
<user />
</sharedItem>
</envelopes>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<templates>
<templateSharedItem>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<owner />
<sharedGroups>
<memberGroupSharedItem>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<group>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<groupId>sample string 1</groupId>
<groupName>sample string 2</groupName>
<groupType>sample string 4</groupType>
<permissionProfileId>sample string 3</permissionProfileId>
<users>
<userInfo />
</users>
</group>
<shared>sample string 1</shared>
</memberGroupSharedItem>
</sharedGroups>
<sharedUsers>
<userSharedItem>
<errorDetails>
<errorCode>SUCCESS</errorCode>
<message></message>
</errorDetails>
<shared>sample string 1</shared>
<user />
</userSharedItem>
</sharedUsers>
<templateId>sample string 1</templateId>
<templateName>sample string 2</templateName>
</templateSharedItem>
</templates>
<user>
<activationAccessCode>sample string 9</activationAccessCode>
<email>sample string 3</email>
<errorDetails>
<errorCode>sample string 1</errorCode>
<message>sample string 2</message>
</errorDetails>
<loginStatus>sample string 7</loginStatus>
<sendActivationEmail>sample string 8</sendActivationEmail>
<uri>sample string 6</uri>
<userId>sample string 2</userId>
<userName>sample string 1</userName>
<userStatus>sample string 5</userStatus>
<userType>sample string 4</userType>
</user>
</memberSharedItems>
</sharedAccess>
<startPosition>sample string 3</startPosition>
<totalSetSize>sample string 2</totalSetSize>
</accountSharedAccess>