# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Application-level templates API
  version: 1.0.0
extends: openapi/nylas-application-level-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['/v3/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List application-level email templates
      effect: read
      questions:
      - Which email templates are defined for my whole application?
      - How do I page through all of my app's templates?
      instructions:
      - text: List all application-level templates.
      - text: Show the first {limit} app templates.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application-level email template
      effect: write
      questions:
      - How do I create a reusable email template for my application?
      - Can I choose which templating engine a new template uses?
      instructions:
      - text: Create an app template named {name} with subject {subject} and body {body}.
        slots:
          name: requestBody.name
          subject: requestBody.subject
          body: requestBody.body
      - text: Add a new application template {name} using the {engine} engine, subject {subject}, body {body}.
        slots:
          name: requestBody.name
          engine: requestBody.engine
          subject: requestBody.subject
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates/{template_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve an application-level template
      effect: read
      questions:
      - How can I view the subject and body of one of my app templates?
      - Can I look up an application template by its ID?
      instructions:
      - text: Get application template {template_id}.
        slots:
          template_id: path.template_id
      - text: Show me the contents of app-level template {template_id}.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates/{template_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an application-level template
      effect: write
      questions:
      - Can I change the subject line of an existing application template?
      - What is the way to edit the body of an app-wide template?
      instructions:
      - text: Change the subject of app template {template_id} to {subject}.
        slots:
          template_id: path.template_id
          subject: requestBody.subject
      - text: Replace the body of application template {template_id} with {body}.
        slots:
          template_id: path.template_id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates/{template_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application-level template
      effect: destructive
      questions:
      - How do I remove an email template from my application?
      - Can I delete an app-level template I no longer use?
      instructions:
      - text: Delete application template {template_id}.
        slots:
          template_id: path.template_id
      - text: Remove app-level template {template_id} permanently.
        slots:
          template_id: path.template_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview raw template HTML with variables
      effect: read
      questions:
      - Can I render ad-hoc template HTML with variables without saving a template first?
      - What does strict mode do when rendering template markup with missing variables?
      instructions:
      - text: Render this HTML {body} with the {engine} engine using variables {variables}.
        slots:
          body: requestBody.body
          engine: requestBody.engine
          variables: requestBody.variables
      - text: Preview unsaved template markup {body} in {engine} with {variables}.
        slots:
          body: requestBody.body
          engine: requestBody.engine
          variables: requestBody.variables
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/templates/{template_id}/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a saved application template
      effect: read
      questions:
      - How do I see what a saved app template looks like once variables are filled in?
      - Can I render an existing application template with my own values?
      instructions:
      - text: Render application template {template_id} with variables {variables}.
        slots:
          template_id: path.template_id
          variables: requestBody.variables
      - text: Fill saved app template {template_id} using {variables} and show the result.
        slots:
          template_id: path.template_id
          variables: requestBody.variables
      method: generated
      generated: '2026-09-26'