# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Docusign Templates API
  version: 1.0.0
extends: openapi/docusign-templates-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: 19
- target: $.paths['/accounts/{accountId}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates in an account
      effect: read
      questions:
      - Which reusable envelope templates exist in my DocuSign account?
      - Can I search templates by text or limit them to those shared by me?
      instructions:
      - text: List the templates in account {accountId}.
        slots:
          accountId: path.accountId
      - text: Search templates in account {accountId} for {search_text}.
        slots:
          accountId: path.accountId
          search_text: query.search_text
      - text: Show templates used between {used_from_date} and {used_to_date}, ordered by {order_by}.
        slots:
          used_from_date: query.used_from_date
          used_to_date: query.used_to_date
          order_by: query.order_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a reusable envelope template
      effect: write
      questions:
      - Can I create a template from scratch with documents, recipients and routing?
      - What can I set when building a new template, like the email subject?
      instructions:
      - text: Create a template named {name} in account {accountId}.
        slots:
          name: requestBody.name
          accountId: path.accountId
      - text: Build a new template {name} with email subject {emailSubject} in folder {folderId}.
        slots:
          name: requestBody.name
          emailSubject: requestBody.emailSubject
          folderId: requestBody.folderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates/{templateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a template's full definition
      effect: read
      questions:
      - What documents, recipients and tabs does a given template contain?
      - Can I fetch one template's routing information?
      instructions:
      - text: Get template {templateId} from account {accountId}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
      - text: Show the documents, recipients and tabs of template {templateId}, including {include}.
        slots:
          templateId: path.templateId
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates/{templateId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename or edit a template
      effect: write
      questions:
      - Can I change a template's name, description or documents after creating it?
      - Is it possible to update the recipients defined on an existing template in one call?
      instructions:
      - text: Rename template {templateId} to {name}.
        slots:
          templateId: path.templateId
          name: requestBody.name
      - text: Update the description of template {templateId} in account {accountId} to {description}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates/{templateId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template
      effect: destructive
      questions:
      - Can a deleted template be recovered from the recycle bin?
      - What happens to a template when I delete it?
      instructions:
      - text: Delete template {templateId}.
        slots:
          templateId: path.templateId
      - text: Move template {templateId} in account {accountId} to the recycle bin.
        slots:
          templateId: path.templateId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates/{templateId}/recipients'].get
  update:
    x-apievangelist-phrasing:
      intent: List the recipients defined on a template
      effect: read
      questions:
      - Which recipient roles and routing order are set up on a template?
      - Can I see each template recipient's tab assignments too?
      instructions:
      - text: List the recipients of template {templateId}.
        slots:
          templateId: path.templateId
      - text: Show template {templateId} recipients in account {accountId} with their tabs.
        slots:
          templateId: path.templateId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/accounts/{accountId}/templates/{templateId}/recipients'].put
  update:
    x-apievangelist-phrasing:
      intent: Update recipients on a template
      effect: write
      questions:
      - Can I change the signers or carbon copies defined on a template?
      - Is it possible to update several template recipients at once?
      instructions:
      - text: Update the signers on template {templateId} to {signers}.
        slots:
          templateId: path.templateId
          signers: requestBody.signers
      - text: Change the carbon copy recipients of template {templateId} in account {accountId} to {carbonCopies}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          carbonCopies: requestBody.carbonCopies
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List templates via the v2 API
      effect: read
      questions:
      - With the v2 API, can I list templates modified within a date range?
      - Can the v2 template list be filtered by user or limited to one folder?
      instructions:
      - text: List v2 templates in account {accountId} modified between {modified_from_date} and {modified_to_date}.
        slots:
          accountId: path.accountId
          modified_from_date: query.modified_from_date
          modified_to_date: query.modified_to_date
      - text: Use the v2 API to list templates in folder {folder} for user {user_id}.
        slots:
          folder: query.folder
          user_id: query.user_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a template via the v2 API
      effect: write
      questions:
      - Can I insert recipient name and email merge fields into a template's email subject when creating it?
      - Does the v2 create-template call accept a multipart request with documents?
      instructions:
      - text: Create a v2 template in account {accountId} with email subject {emailSubject}.
        slots:
          accountId: path.accountId
          emailSubject: requestBody.emailSubject
      - text: Create a v2 template from definition {envelopeTemplateDefinition} with documents {documents}.
        slots:
          envelopeTemplateDefinition: requestBody.envelopeTemplateDefinition
          documents: requestBody.documents
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a template via the v2 API
      effect: read
      questions:
      - Using the v2 API, how can I retrieve one template's definition?
      - Can the v2 single-template lookup include extra details?
      instructions:
      - text: Get template {templateId} through the v2 API.
        slots:
          templateId: path.templateId
      - text: Fetch the v2 definition of template {templateId} in account {accountId}, including {include}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a template via the v2 API
      effect: write
      questions:
      - Through the v2 API, can I change settings like reassignment or brand on an existing template?
      - Can I switch on signer mobile signing for a template using v2?
      instructions:
      - text: Update v2 template {templateId} to use brand {brandId}.
        slots:
          templateId: path.templateId
          brandId: requestBody.brandId
      - text: Change the v2 template {templateId} in account {accountId} email subject to {emailSubject}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          emailSubject: requestBody.emailSubject
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/{templatePart}'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a template with a member group
      effect: write
      questions:
      - Can I share a template with a group of users in my account?
      - Which groups should a template be shared with so the team can use it?
      instructions:
      - text: Share template {templateId} with groups {groups} via part {templatePart}.
        slots:
          templateId: path.templateId
          groups: requestBody.groups
          templatePart: path.templatePart
      - text: Grant group access to template {templateId} in account {accountId} using {templatePart}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          templatePart: path.templatePart
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/{templatePart}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing a template with a group
      effect: destructive
      questions:
      - Can I remove a member group's access to a shared template?
      - What happens when I unshare a template from a group?
      instructions:
      - text: Remove groups {groups} from sharing on template {templateId} via part {templatePart}.
        slots:
          groups: requestBody.groups
          templateId: path.templateId
          templatePart: path.templatePart
      - text: Unshare template {templateId} in account {accountId} from its group using {templatePart}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          templatePart: path.templatePart
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}/pages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get page images of a template document
      effect: read
      questions:
      - Can I get preview images of every page in a template's document?
      - Is it possible to control the resolution of template page images?
      instructions:
      - text: Get page images for document {documentId} in template {templateId}.
        slots:
          documentId: path.documentId
          templateId: path.templateId
      - text: Render pages of document {documentId} in template {templateId} of account {accountId} at {dpi} dpi.
        slots:
          documentId: path.documentId
          templateId: path.templateId
          accountId: path.accountId
          dpi: query.dpi
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}/pages/{pageNumber}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a page from a template document
      effect: destructive
      questions:
      - Can I remove a single page from a document inside a template?
      - Which page gets deleted when I remove one from a template document?
      instructions:
      - text: Delete page {pageNumber} of document {documentId} in template {templateId}.
        slots:
          pageNumber: path.pageNumber
          documentId: path.documentId
          templateId: path.templateId
      - text: Remove page {pageNumber} from document {documentId} in template {templateId} of account {accountId}.
        slots:
          pageNumber: path.pageNumber
          documentId: path.documentId
          templateId: path.templateId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}/pages/{pageNumber}/page_image'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one page image from a template
      effect: read
      questions:
      - Can I fetch a single page of a template document as an image for display?
      - What size limits can I set on a template page image?
      instructions:
      - text: Show page {pageNumber} of document {documentId} in template {templateId} as an image.
        slots:
          pageNumber: path.pageNumber
          documentId: path.documentId
          templateId: path.templateId
      - text: Get the page {pageNumber} image of template {templateId} document {documentId} in account {accountId} at most {max_width} wide.
        slots:
          pageNumber: path.pageNumber
          templateId: path.templateId
          documentId: path.documentId
          accountId: path.accountId
          max_width: query.max_width
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/documents/{documentId}/pages/{pageNumber}/page_image'].put
  update:
    x-apievangelist-phrasing:
      intent: Rotate a page in a template document
      effect: write
      questions:
      - Can I rotate a sideways page in a template document to the left or right?
      - Is a page rotation in a template saved for display?
      instructions:
      - text: Rotate page {pageNumber} of document {documentId} in template {templateId} to the {rotate}.
        slots:
          pageNumber: path.pageNumber
          documentId: path.documentId
          templateId: path.templateId
          rotate: requestBody.rotate
      - text: Turn page {pageNumber} of template {templateId} document {documentId} in account {accountId}.
        slots:
          pageNumber: path.pageNumber
          templateId: path.templateId
          documentId: path.documentId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/notification'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a template's reminder and expiration settings
      effect: read
      questions:
      - What reminders and expiration rules are set on a template?
      - Does a template use the account default notification settings?
      instructions:
      - text: Show the reminder and expiration settings for template {templateId}.
        slots:
          templateId: path.templateId
      - text: Get notification settings of template {templateId} in account {accountId}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/accounts/{accountId}/templates/{templateId}/notification'].put
  update:
    x-apievangelist-phrasing:
      intent: Set reminders and expirations on a template
      effect: write
      questions:
      - Can I make envelopes sent from a template remind signers automatically?
      - Can a template's expiration rules be changed or reset to account defaults?
      instructions:
      - text: Set reminders {reminders} on template {templateId}.
        slots:
          reminders: requestBody.reminders
          templateId: path.templateId
      - text: Update template {templateId} in account {accountId} expirations to {expirations}.
        slots:
          templateId: path.templateId
          accountId: path.accountId
          expirations: requestBody.expirations
      method: generated
      generated: '2026-10-01'