# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DocuSign REST Envelope Document Visibility API
  version: 1.0.0
extends: openapi/docusign-envelopedocumentvisibility-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/document_visibility'].get
  update:
    x-apievangelist-phrasing:
      intent: See which envelope documents a recipient can view
      effect: read
      questions:
      - Which documents in an envelope can a particular recipient see?
      - Is any document hidden from a specific signer on an envelope?
      instructions:
      - text: Show document visibility for recipient {recipientId} on envelope {envelopeId}.
        slots:
          recipientId: path.recipientId
          envelopeId: path.envelopeId
      - text: Get which documents recipient {recipientId} can view in envelope {envelopeId} of account {accountId}.
        slots:
          recipientId: path.recipientId
          envelopeId: path.envelopeId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/document_visibility'].put
  update:
    x-apievangelist-phrasing:
      intent: Set document visibility for one envelope recipient
      effect: write
      questions:
      - Can I hide a document from one specific recipient on an envelope?
      - Is it possible to change what a single signer can view?
      instructions:
      - text: Set document visibility for recipient {recipientId} on envelope {envelopeId} to {documentVisibility}.
        slots:
          recipientId: path.recipientId
          envelopeId: path.envelopeId
          documentVisibility: requestBody.documentVisibility
      - text: Hide documents from recipient {recipientId} on envelope {envelopeId} in account {accountId}.
        slots:
          recipientId: path.recipientId
          envelopeId: path.envelopeId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/recipients/document_visibility'].put
  update:
    x-apievangelist-phrasing:
      intent: Set document visibility for all envelope recipients
      effect: write
      questions:
      - Can I update document visibility for several recipients of an envelope at once?
      - What's the bulk way to control which recipients see which documents?
      instructions:
      - text: Apply document visibility {documentVisibility} across all recipients on envelope {envelopeId}.
        slots:
          documentVisibility: requestBody.documentVisibility
          envelopeId: path.envelopeId
      - text: Update visibility for every recipient of envelope {envelopeId} in account {accountId}.
        slots:
          envelopeId: path.envelopeId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'