# 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 Templates API
  version: 1.0.0
extends: openapi/docusign-envelopetemplates-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}/envelopes/{envelopeId}/documents/{documentId}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates applied to an envelope document
      effect: read
      questions:
      - Which templates are applied to a particular document in an envelope?
      - Can I see the templates matched to just one document?
      instructions:
      - text: List templates on document {document} in envelope {envelope}, account {account}.
        slots:
          document: path.documentId
          envelope: path.envelopeId
          account: path.accountId
      - text: Show which templates were applied to document {document} of envelope {envelope}.
        slots:
          document: path.documentId
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply templates to an envelope document
      effect: write
      questions:
      - How do I apply a template to one document inside an envelope?
      - Can I add several templates to a single envelope document?
      instructions:
      - text: Apply templates {documentTemplates} to document {document} in envelope {envelope}, account {account}.
        slots:
          documentTemplates: requestBody.documentTemplates
          document: path.documentId
          envelope: path.envelopeId
          account: path.accountId
      - text: Add template matches {documentTemplates} to document {document} of envelope {envelope}.
        slots:
          documentTemplates: requestBody.documentTemplates
          document: path.documentId
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/documents/{documentId}/templates/{templateId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a template from an envelope document
      effect: destructive
      questions:
      - How do I detach a template from a document in an envelope?
      - Can I remove one template without affecting the others on the document?
      instructions:
      - text: Remove template {template} from document {document} in envelope {envelope}, account {account}.
        slots:
          template: path.templateId
          document: path.documentId
          envelope: path.envelopeId
          account: path.accountId
      - text: Detach template {template} from document {document} of envelope {envelope}.
        slots:
          template: path.templateId
          document: path.documentId
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates used in an envelope
      effect: read
      questions:
      - Which server-side templates were used to build an envelope?
      - What are the names and IDs of templates in an envelope?
      instructions:
      - text: List templates used in envelope {envelope}, account {account}.
        slots:
          envelope: path.envelopeId
          account: path.accountId
      - text: Show the template names and IDs behind envelope {envelope}.
        slots:
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/envelopes/{envelopeId}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Add templates to an envelope
      effect: write
      questions:
      - How do I add a template to an envelope I've already created?
      - Can I apply templates at the envelope level rather than per document?
      instructions:
      - text: Add templates {documentTemplates} to envelope {envelope}, account {account}.
        slots:
          documentTemplates: requestBody.documentTemplates
          envelope: path.envelopeId
          account: path.accountId
      - text: Apply templates {documentTemplates} to the whole envelope {envelope}.
        slots:
          documentTemplates: requestBody.documentTemplates
          envelope: path.envelopeId
      method: generated
      generated: '2026-10-01'