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

The JSON we had used in the API is:

{
    "userSettings": [
        {
            "name": "canManageAccount",
            "value": "false"
        },
        {
            "name": "canSendEnvelope",
            "value": "true"
        }
    ]
}

We found that we are able to use the API to enable or disable the "Send Envelopes" permission for a user; but not for the "Manage Account" permission.

Please help troubleshooting the problem.

Answer 1

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>

Answer 2

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.