Envelope Document Visibility

Updates document visibility for a recipient

PUT
/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/document_visibility

This method updates document visibility for a recipient.

Note: A document cannot be hidden from a recipient if the recipient has tabs assigned to them on the document. Carbon Copy, Certified Delivery (Needs to Sign), Editor, and Agent recipients can always see all documents.

Authorization

OAuth2
AuthorizationBearer <token>

OAuth 2.0 access token obtained via Authorization Code Grant or JWT Grant.

In: header

Path Parameters

accountId*string

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

envelopeId*string

The envelope's GUID.

Example: 93be49ab-xxxx-xxxx-xxxx-f752070d71ec

recipientId*string

A local reference used to map recipients to other objects, such as specific document tabs.

A recipientId must be either an integer or a GUID, and the recipientId must be unique within an envelope.

For example, many envelopes assign the first recipient a recipientId of 1.

Request Body

application/json

A list of documentVisibility objects that specify whether documents are visible to recipients.

documentVisibility?array<>

An array of documentVisibility objects that specifies which documents are visible to which recipients.

Response Body

application/json

application/json

curl -X PUT "https://example.com/v2.1/accounts/string/envelopes/string/recipients/string/document_visibility" \  -H "Content-Type: application/json" \  -d '{}'
{  "documentVisibility": [    {      "documentId": "string",      "errorDetails": {        "errorCode": "string",        "message": "string"      },      "recipientId": "string",      "rights": "string",      "visible": "string"    }  ]}