通过收件人锁定，通过docusign API将信封重新发送给收件人

Question

In our app we have a way for users to generate docusign envelopes which then get tracked by status and signed through a chain of recipients.

I've added a feature to resend the document in our interface. Using XML through the API I think I'm correctly requesting a resend of the envelope to recipients that are in the "delivered" status (meaning they were sent the document but haven't signed yet I think). I followed the concepts here: Resend DocuSign Emails

However I am unfortunately receiving an error when sending the resend request for the document:

ErrorCode: RECIPIENTS_LOCKED

Message: Recipients are locked and cannot be modified.

I went back to the template and looked for options that might lock down changes to recipients (even though no changes are actually being made) and could only find the option "Sender cannot Add, Edit, Delete Recipients" in the Recipients and Routing section of template. Unchecking this option did not solve the issue though and I still get the same error when trying to resend documents.

Is there another way I can unlock recipients of an envelope that will allow me to resend documents to them using the API?

Edit

Endpoint URL: https://na2.docusign.net/restapi/v2/accounts/[accountId]/envelopes/[envelopeId]/recipients?resend_envelope=true

Request Body:

string requestBody = "<recipients xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://www.docusign.com/restapi\">" +
            "<signers><signer>" +
                "<recipientId>" + recipientId.ToString() + "</recipientId>" +
                "<name>" + recipientName + "</name>" +
                "<email>" + recipientEmail + "</email>" +
            "</signer></signers></recipients>";

Answer 1

Did some more digging on this one and was able to reproduce this behavior under the following conditions:

If you create an envelope from a template and specify the recipientsLock=true on the createEnvelope request, and you perform a correct w/re-send, you must specify a valid recipientID defined on the template. Please make sure that you are using the recipientID value from the GET and NOT the recipientIDGuid or UserID.

API information on creating template w/recipientsLock: https://www.docusign.com/p/RESTAPIGuide/RESTAPIGuide.htm#REST%20API%20References/Post%20Template.htm?Highlight=recipientslock