Request

HTTP request

PUT /v2/accounts/{accountId}/templates/{templateId}/recipients/document_visibility

Parameters

Parameter NameValueDescription
Path Parameters
accountIdstring

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

templateIdstring

The ID of the template being accessed.

Responses

CodeDescriptionReference
200

Successful response.

TemplateDocumentVisibility
400

Error encountered.

errorDetails

SDK Method

Templates::updateTemplateRecipientsDocumentVisibility

Definitions

documentVisibility

documentIdstring

Specifies the document ID number that the tab is placed on. This must refer to an existing Document's ID attribute.

errorDetailserrorDetails

recipientIdstring

Unique for the recipient. It is used by the tab element to indicate which recipient is to sign the Document.

rightsstring

visiblestring

errorDetails

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

errorCodestring

An error code associated with the error.

messagestring

A short error message.

TemplateDocumentVisibility

documentVisibility[documentVisibility]

Examples

Generic JSON Request/Response

Request
{
  "password": "sample string 1",
  "documentVisibility": [
    {
      "recipientId": "sample string 1",
      "documentId": "sample string 2",
      "visible": "sample string 3",
      "rights": "sample string 4"
    }
  ]
}
Response
{
  "password": "sample string 1",
  "documentVisibility": [
    {
      "recipientId": "sample string 1",
      "documentId": "sample string 2",
      "visible": "sample string 3",
      "rights": "sample string 4",
      "errorDetails": {
        "errorCode": "sample string 1",
        "message": "sample string 2"
      }
    }
  ]
}
Generic XML Request/Response

Request
<templateDocumentVisibilityList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API_REST.Models.v2">
  <documentVisibility xmlns="http://www.docusign.com/restapi">
    <documentVisibility>
      <documentId>sample string 2</documentId>
      <recipientId>sample string 1</recipientId>
      <rights>sample string 4</rights>
      <visible>sample string 3</visible>
    </documentVisibility>
  </documentVisibility>
  <password>sample string 1</password>
</templateDocumentVisibilityList> 
Response
<templateDocumentVisibilityList xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API_REST.Models.v2">
  <documentVisibility xmlns="http://www.docusign.com/restapi">
    <documentVisibility>
      <documentId>sample string 2</documentId>
      <errorDetails>
        <errorCode>sample string 1</errorCode>
        <message>sample string 2</message>
      </errorDetails>
      <recipientId>sample string 1</recipientId>
      <rights>sample string 4</rights>
      <visible>sample string 3</visible>
    </documentVisibility>
  </documentVisibility>
  <password>sample string 1</password>
</templateDocumentVisibilityList> 
}} />