# 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 Documents API
  version: 1.0.0
extends: openapi/docusign-templatedocuments-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}/documents'].get
  update:
    x-apievangelist-phrasing:
      intent: List the documents in a template
      effect: read
      questions:
      - Which documents are included in a template?
      - Can I see the document list of a template before using it?
      instructions:
      - text: List documents in template {template} in account {account}.
        slots:
          template: path.templateId
          account: path.accountId
      - text: Show what documents template {template} on account {account} contains.
        slots:
          template: path.templateId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents'].put
  update:
    x-apievangelist-phrasing:
      intent: Add documents to a template
      effect: write
      questions:
      - How do I add several documents to an existing template?
      - Can I keep existing tabs when adding documents to a template?
      instructions:
      - text: 'Add these documents to template {template} in account {account}: {docs}.'
        slots:
          template: path.templateId
          account: path.accountId
          docs: requestBody.documents
      - text: Attach new documents to template {template} on account {account}.
        slots:
          template: path.templateId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove documents from a template
      effect: destructive
      questions:
      - Can I delete one or more documents from a template?
      - How do I strip outdated documents out of a template?
      instructions:
      - text: Delete documents {docs} from template {template} in account {account}.
        slots:
          docs: requestBody.documents
          template: path.templateId
          account: path.accountId
      - text: Remove these documents from template {template} on account {account}.
        slots:
          template: path.templateId
          account: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a template document as PDF
      effect: read
      questions:
      - How do I download a template's document as a PDF?
      - Can I get all of a template's documents combined into one PDF?
      instructions:
      - text: Download document {document} from template {template} in account {account}.
        slots:
          document: path.documentId
          template: path.templateId
          account: path.accountId
      - text: Get the combined PDF of template {template} on account {account} using document {document}.
        slots:
          template: path.templateId
          account: path.accountId
          document: path.documentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace one document in a template
      effect: write
      questions:
      - Can I add a single document to a template at a specific document ID?
      - How do I replace one document in a template?
      instructions:
      - text: Put document {document} into template {template} in account {account}.
        slots:
          document: path.documentId
          template: path.templateId
          account: path.accountId
      - text: Replace document {document} of template {template} on account {account} with a new file.
        slots:
          document: path.documentId
          template: path.templateId
          account: path.accountId
      method: generated
      generated: '2026-10-01'