# 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 Template Recipients API
  version: 1.0.0
extends: openapi/docusign-templaterecipients-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: 5
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/recipients'].get
  update:
    x-apievangelist-phrasing:
      intent: List the recipients on a template
      effect: read
      questions:
      - Who are the recipients defined on a template?
      - Can I include each template recipient's tabs and anchor locations?
      instructions:
      - text: List recipients on template {template} in account {account}.
        slots:
          template: path.templateId
          account: path.accountId
      - text: Show template {template}'s recipients with their tabs.
        slots:
          template: path.templateId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/recipients'].put
  update:
    x-apievangelist-phrasing:
      intent: Update existing recipients on a template
      effect: write
      questions:
      - Can I change a template recipient's email or routing order?
      - Which recipient properties are editable on a template?
      instructions:
      - text: Update signers {signers} on template {template} in account {account}.
        slots:
          signers: requestBody.signers
          template: path.templateId
          account: path.accountId
      - text: Change the routing order of existing recipients on template {template} to match {signers}.
        slots:
          template: path.templateId
          signers: requestBody.signers
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/recipients'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new recipients to a template
      effect: write
      questions:
      - How do I add another signer to an existing template?
      - Can I add carbon copy recipients to a template?
      instructions:
      - text: Add signers {signers} to template {template} in account {account}.
        slots:
          signers: requestBody.signers
          template: path.templateId
          account: path.accountId
      - text: Add carbon copy recipients {cc} to template {template}.
        slots:
          cc: requestBody.carbonCopies
          template: path.templateId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/recipients'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove several recipients from a template
      effect: destructive
      questions:
      - Can I remove multiple recipients from a template at once?
      - What identifies which template recipients get deleted in bulk?
      instructions:
      - text: Delete recipients {signers} from template {template} in account {account}.
        slots:
          signers: requestBody.signers
          template: path.templateId
          account: path.accountId
      - text: Bulk remove the listed signers {signers} from template {template}.
        slots:
          signers: requestBody.signers
          template: path.templateId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/recipients/{recipientId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one recipient from a template
      effect: destructive
      questions:
      - How do I delete just one recipient from a template?
      - Can I drop a single template recipient by their recipient ID?
      instructions:
      - text: Delete recipient {recipient} from template {template} in account {account}.
        slots:
          recipient: path.recipientId
          template: path.templateId
          account: path.accountId
      - text: Remove only recipient {recipient} from template {template}.
        slots:
          recipient: path.recipientId
          template: path.templateId
      method: generated
      generated: '2026-10-01'