# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Klaviyo Templates API
  version: 1.0.0
extends: openapi/klaviyo-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: 12
- target: $.paths['/api/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List email templates
      effect: read
      questions:
      - What email templates do I have in my Klaviyo account?
      - Can I include the full drag-and-drop definition when listing templates?
      - Is there a way to filter templates by name or creation date?
      instructions:
      - text: List all my email templates.
      - text: Show templates matching {filter}, sorted by {sort}.
        slots:
          filter: query.filter
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an HTML or drag-and-drop template
      effect: write
      questions:
      - How do I upload a new HTML email template?
      - Is there a cap on how many templates I can create through the API?
      instructions:
      - text: 'Create a template from this HTML: {template}.'
        slots:
          template: requestBody.data
      - text: Add a new drag-and-drop template named {template}.
        slots:
          template: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/templates/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one template by ID
      effect: read
      questions:
      - How do I view the HTML of a specific template?
      - Can I fetch one template with its full definition?
      instructions:
      - text: Get template {template_id}.
        slots:
          template_id: path.id
      - text: Show template {template_id} including {additional_fields}.
        slots:
          template_id: path.id
          additional_fields: query.additional-fields[template]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/templates/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template
      effect: destructive
      questions:
      - How do I get rid of an email template I no longer use?
      - Can I delete a template by its ID?
      instructions:
      - text: Delete template {template_id}.
        slots:
          template_id: path.id
      - text: Remove the outdated template {template_id}.
        slots:
          template_id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/templates/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a template's content
      effect: write
      questions:
      - Can I replace the HTML of a template I already created?
      - What's the way to rename an existing template?
      instructions:
      - text: Update template {template_id} with {changes}.
        slots:
          template_id: path.id
          changes: requestBody.data
      - text: Replace the HTML in template {template_id} with {changes}.
        slots:
          template_id: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-universal-content'].get
  update:
    x-apievangelist-phrasing:
      intent: List universal content blocks
      effect: read
      questions:
      - Which reusable universal content blocks exist in my account?
      - Can I filter universal content by name or date?
      instructions:
      - text: List all universal content blocks.
      - text: Show universal content matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-universal-content'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a universal content block
      effect: write
      questions:
      - How do I create a reusable content block like a footer button or text?
      - Which block types are supported for universal content?
      instructions:
      - text: Create universal content {content_block}.
        slots:
          content_block: requestBody.data
      - text: Add a reusable text or button block defined as {content_block}.
        slots:
          content_block: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-universal-content/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one universal content block
      effect: read
      questions:
      - What's inside a specific universal content block?
      - Can I fetch a reusable block by its ID?
      instructions:
      - text: Get universal content {content_id}.
        slots:
          content_id: path.id
      - text: Show the definition of reusable block {content_id}.
        slots:
          content_id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-universal-content/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a universal content block
      effect: destructive
      questions:
      - How do I remove a reusable content block?
      - Can I delete universal content by ID?
      instructions:
      - text: Delete universal content {content_id}.
        slots:
          content_id: path.id
      - text: Remove the reusable block {content_id} from my account.
        slots:
          content_id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-universal-content/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a universal content block
      effect: write
      questions:
      - Can I edit a shared content block so every email using it changes?
      - Which block types allow their definition to be updated?
      instructions:
      - text: Update universal content {content_id} with {changes}.
        slots:
          content_id: path.id
          changes: requestBody.data
      - text: Change the definition of reusable block {content_id} to {changes}.
        slots:
          content_id: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-render'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a template with sample context
      effect: read
      questions:
      - How can I preview what a template looks like with real profile data filled in?
      - Can I get the HTML, AMP and plain text versions of a rendered template?
      instructions:
      - text: 'Render the template with this context: {render_request}.'
        slots:
          render_request: requestBody.data
      - text: Preview a template's HTML and text output using {render_request}.
        slots:
          render_request: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/template-clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a template
      effect: write
      questions:
      - Can I make a copy of an existing template to edit separately?
      - Does cloning count toward the template creation limit?
      instructions:
      - text: Clone the template given in {clone_request}.
        slots:
          clone_request: requestBody.data
      - text: 'Make a copy of a template under a new name: {clone_request}.'
        slots:
          clone_request: requestBody.data
      method: generated
      generated: '2026-09-26'