Deletes the specified custom user settings for a single user.

###Deleting Grouped Custom User Settings###

If the custom user settings you want to delete are grouped, you must include the following information in the header, after Content-Type, in the request:

X-DocuSign-User-Settings-Key:group_name

Where the group_name is your designated name for the group of customer user settings.

If the extra header information is not included, only the custom user settings that were added without a group are deleted.

Request

HTTP request

DELETE /v2.1/accounts/{accountId}/users/{userId}/custom_settings

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

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

userIdstring

The ID of the user to access. Generally this is the ID of the current authenticated user, but if the authenticated user is an Administrator on the account, userId can represent another user whom the Administrator is accessing.

Request Body

UserCustomSettings

Responses

CodeDescriptionReference
200

Successful response.

UserCustomSettings
400

Error encountered.

errorDetails

SDK Method

Users::deleteCustomSettings

Definitions

errorDetails

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

errorCodestring

The code associated with the error condition.

messagestring

A brief message describing the error condition.

nameValue

errorDetailserrorDetails

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

namestring

The name of the item.

originalValuestring

The initial value of the item.

valuestring

The current value of the item.

UserCustomSettings

Users' custom settings

customSettings[nameValue]

The name/value pair information for the user custom setting.

Examples

Generic JSON Request/Response

Request
{
  "customSettings": [
    {}
  ]
}
Response
{
  "customSettings": [
    {}
  ]
}
Generic XML Request/Response

Request
<customSettingsInformation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <customSettings>
    <nameValue />
  </customSettings>
</customSettingsInformation> 
Response
<customSettingsInformation xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.docusign.com/restapi">
  <customSettings>
    <nameValue />
  </customSettings>
</customSettingsInformation> 
}} />