# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Mailchimp Templates API
  version: 1.0.0
extends: openapi/mailchimp-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: 14
- target: $.paths['/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List marketing email templates
      effect: read
      questions:
      - Which email templates are available in my marketing account?
      - Can I list only the templates I created myself, sorted by date?
      - What templates are stored in a particular template folder?
      instructions:
      - text: List my marketing email templates.
      - text: Show marketing templates in folder {folder_id}.
        slots:
          folder_id: query.folder_id
      - text: List templates of type {type} created since {since_date_created}.
        slots:
          type: query.type
          since_date_created: query.since_date_created
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a classic marketing template from HTML
      effect: write
      questions:
      - How do I upload my own HTML as a reusable campaign template?
      - Can I put a new campaign template straight into a folder when I create it?
      instructions:
      - text: 'Create a classic campaign template named {name} from this HTML: {html}.'
        slots:
          name: requestBody.name
          html: requestBody.html
      - text: Add campaign template {name} with HTML {html} into folder {folder_id}.
        slots:
          name: requestBody.name
          html: requestBody.html
          folder_id: requestBody.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a marketing template's details
      effect: read
      questions:
      - What type, category and thumbnail does a specific campaign template have?
      - Can I look up one marketing template by its numeric ID?
      instructions:
      - text: Show campaign template {template_id}.
        slots:
          template_id: path.template_id
      - text: Get details of marketing template {template_id}, including when it was created.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a marketing template
      effect: destructive
      questions:
      - Can I delete a campaign template I no longer use?
      - What's the way to remove a user-created marketing template by ID?
      instructions:
      - text: Delete campaign template {template_id}.
        slots:
          template_id: path.template_id
      - text: Remove marketing template {template_id} from my account.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a marketing template's name, HTML or folder
      effect: write
      questions:
      - Can I replace the HTML of an existing campaign template?
      - How do I move a campaign template into a different folder?
      instructions:
      - text: 'Update campaign template {template_id}: name {name}, HTML {html}.'
        slots:
          template_id: path.template_id
          name: requestBody.name
          html: requestBody.html
      - text: Move campaign template {template_id} named {name} with HTML {html} into folder {folder_id}.
        slots:
          template_id: path.template_id
          name: requestBody.name
          html: requestBody.html
          folder_id: requestBody.folder_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/{template_id}/default-content'].get
  update:
    x-apievangelist-phrasing:
      intent: View a template's editable sections
      effect: read
      questions:
      - Which sections of a campaign template can I edit, and what's their default content?
      - Can I see the placeholder content in each editable region of a template?
      instructions:
      - text: Show the editable sections and default content of template {template_id}.
        slots:
          template_id: path.template_id
      - text: List default content blocks for campaign template {template_id}.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a transactional email template
      effect: write
      questions:
      - How do I create a transactional email template with a default subject and from address?
      - Can I add a transactional template as a draft without publishing it?
      instructions:
      - text: Add transactional template {name} with code {code} using API key {key}.
        slots:
          name: requestBody.name
          code: requestBody.code
          key: requestBody.key
      - text: Create transactional template {name} with subject {subject} from {from_email}, publish {publish}, key {key}.
        slots:
          name: requestBody.name
          subject: requestBody.subject
          from_email: requestBody.from_email
          publish: requestBody.publish
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/info'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a transactional template's details
      effect: read
      questions:
      - What code, subject and labels does a named transactional template have?
      - Can I see both the draft and published versions of a transactional template?
      instructions:
      - text: Show transactional template {name} using key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      - text: Get the published code of transactional template {name} with API key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a transactional template's draft
      effect: write
      questions:
      - Can I change the code or subject of a transactional template and leave other fields untouched?
      - How do I update a transactional template and publish the change right away?
      instructions:
      - text: Update transactional template {name} with new code {code} using key {key}.
        slots:
          name: requestBody.name
          code: requestBody.code
          key: requestBody.key
      - text: Change the subject of transactional template {name} to {subject}, key {key}.
        slots:
          name: requestBody.name
          subject: requestBody.subject
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a transactional template's draft
      effect: write
      questions:
      - How do I make my draft changes to a transactional template go live for new messages?
      - Will publishing a transactional template affect messages sent after it?
      instructions:
      - text: Publish the draft of transactional template {name} using key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      - text: Push draft content live for transactional template {name}, API key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a transactional template
      effect: destructive
      questions:
      - Can I delete a transactional email template by its name?
      - What's the way to remove an unused transactional template?
      instructions:
      - text: Delete transactional template {name} using key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      - text: Remove the transactional template called {name}, API key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List transactional templates
      effect: read
      questions:
      - Which transactional email templates exist on my account?
      - Can I filter my transactional templates by label?
      instructions:
      - text: List all transactional templates using key {key}.
        slots:
          key: requestBody.key
      - text: Show transactional templates labeled {label}, API key {key}.
        slots:
          label: requestBody.label
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/time-series'].post
  update:
    x-apievangelist-phrasing:
      intent: Get hourly send stats for a transactional template
      effect: read
      questions:
      - How has a transactional template performed hour by hour over the last 30 days?
      - Can I see recent opens and clicks for messages using one template?
      instructions:
      - text: Show the last 30 days of hourly stats for template {name} using key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      - text: Get the send history of transactional template {name}, API key {key}.
        slots:
          name: requestBody.name
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templates/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a transactional template to HTML
      effect: read
      questions:
      - Can I preview the final HTML of a template with my content and merge fields filled in?
      - What does a transactional template look like once merge variables are injected?
      instructions:
      - text: Render template {template_name} with content {template_content} using key {key}.
        slots:
          template_name: requestBody.template_name
          template_content: requestBody.template_content
          key: requestBody.key
      - text: Preview template {template_name} with content {template_content} and merge vars {merge_vars}, key {key}.
        slots:
          template_name: requestBody.template_name
          template_content: requestBody.template_content
          merge_vars: requestBody.merge_vars
          key: requestBody.key
      method: generated
      generated: '2026-09-26'