---
title: "Updates document visibility for a recipient"
method: PUT
path: "/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/document_visibility"
tags: ["EnvelopeDocumentVisibility"]
---

# Updates document visibility for a recipient

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

## Request

- Base URL: `https://www.docusign.net/restapi`
- URL: `https://www.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/document_visibility`
- Auth: none declared

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.

## Path parameters

- `accountId` string, required
- `envelopeId` string, required
- `recipientId` string, required

## Request body

- DocumentVisibilityList: A list of `documentVisibility` objects that specify whether documents are visible to recipients.
  - `documentVisibility` DocumentVisibility[]: An array of `documentVisibility` objects that specifies which documents are visible to which recipients.
    - `documentId` string: Specifies the document ID number that the tab is placed on. This must refer to an existing Document's ID attribute.
    - `errorDetails` ErrorDetails: This object describes errors that occur. It is only valid for responses and ignored in requests.
      - `errorCode` string: The code associated with the error condition.
      - `message` string: A brief message describing the error condition.
    - `recipientId` string: The ID of the recipient to whom the document visibility setting is applied. This value should match the `recipientId` defined in the recipient object.
    - `rights` string: Indicates whether the document is editable: - `editable` - `read_only`
    - `visible` string: When **true,** the document is visible to the recipient.

## Response `200`

Successful response.

## Other responses

- `400`: Error encountered.

---

[API](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api.md) - [All operations](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/revisions/77f1998c313d?raw)