Fail to update user's “Manage Account” permission through “Modify User Account Settings” API

Question

We are using DocuSign REST API v2, and we are using the \"Modify User Account Settings\" method

Endpoint: /accounts/{accountId}/users/{userId}/settings

Answer 1

Note the User Settings doc permissions comment:

Authorization required for changing the canManageAccount permission: Admin & not setting for self

So I would first check that the API user is itself an Administrator for the account. Check this by using the loginInformation method with login_settings=all

and looking for

....
"loginUserSettings": [
    {
      "name": "canManageAccount",
      "value": "true"
    },

in the response.

Also check that you are not doing a SOBO request for the Modify User Account Settings call.

Answer 2

The updating of this setting (canManageAccount) has been broken in REST for awhile now, it works in SOAP though. There is a bug with DocuSign Engineering to address the REST portion, I do not know when it will be fixed and live in Production though.

How to do it in SOAP

SOAP: https://demo.docusign.net/api/3.0/dsapi.asmx

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
 <UpdateMemberSettings xmlns="http://www.docusign.net/API/AccountManagement">
  <AccountId>{accountId}</AccountId>
  <UserId>{userId}</UserId>
  <MemberSettings>
    <CanManageAccount>true</CanManageAccount>
  </MemberSettings>
 </UpdateMemberSettings>
</soap:Body>
</soap:Envelope>