# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio Templates API
  version: 1.0.0
extends: openapi/twilio-templates-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List my email templates
      effect: read
      questions:
      - Which transactional email templates do I have?
      - Can I list only my dynamic templates and leave out legacy ones?
      instructions:
      - text: List all my email templates.
      - text: Show my {generation} email templates, {page_size} per page.
        slots:
          generation: query.generations
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an email template
      effect: write
      questions:
      - How do I create a new transactional email template?
      - Can I choose between a legacy and a dynamic template when I create one?
      instructions:
      - text: Create an email template named {name}.
        slots:
          name: requestBody.name
      - text: Make a new {generation} email template called {name}.
        slots:
          generation: requestBody.generation
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an email template
      effect: read
      questions:
      - How can I see the details and versions of one email template?
      - Can I fetch a single email template by its ID?
      instructions:
      - text: Show email template {template}.
        slots:
          template: path.template_id
      - text: Get the versions attached to email template {template}.
        slots:
          template: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email template
      effect: destructive
      questions:
      - How do I delete an email template I no longer send?
      - Can I permanently remove an old transactional template?
      instructions:
      - text: Delete email template {template}.
        slots:
          template: path.template_id
      - text: Permanently remove the unused template {template}.
        slots:
          template: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename an email template
      effect: write
      questions:
      - Can I rename an email template after it's created?
      - What can I change on an existing template itself, as opposed to its versions?
      instructions:
      - text: Rename email template {template} to {name}.
        slots:
          template: path.template_id
          name: requestBody.name
      - text: Change the name of existing template {template} to {name}.
        slots:
          template: path.template_id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}/versions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a version to an email template
      effect: write
      questions:
      - How do I add new HTML content and a subject line to an email template?
      - Can I make a new template version active right away and preview it with test data?
      - Will a plain-text version be generated from my HTML automatically?
      instructions:
      - text: Add version {name} to template {template} with subject {subject} and HTML {html}.
        slots:
          name: requestBody.name
          template: path.template_id
          subject: requestBody.subject
          html: requestBody.html_content
      - text: 'Create version {name} on template {template}, subject {subject}, and make it active: {active}.'
        slots:
          name: requestBody.name
          template: path.template_id
          subject: requestBody.subject
          active: requestBody.active
      - text: Add version {name} with subject {subject} to template {template} and preview it with {test_data}.
        slots:
          name: requestBody.name
          subject: requestBody.subject
          template: path.template_id
          test_data: requestBody.test_data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/Templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List Verify message templates
      effect: read
      questions:
      - What message templates are available for my verification codes?
      - Can I search Verify templates by their friendly name?
      instructions:
      - text: List the verification message templates on my account.
      - text: Find Verify templates named {friendly_name}.
        slots:
          friendly_name: query.FriendlyName
      method: generated
      generated: '2026-09-26'