# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Grant-level templates API
  version: 1.0.0
extends: openapi/nylas-grant-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/grants/{grant_id}/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's email templates
      effect: read
      questions:
      - What email templates are saved for this user's grant?
      - Can I page through a grant's templates?
      instructions:
      - text: List all templates for grant {grant}.
        slots:
          grant: path.grant_id
      - text: Show the saved email templates on {grant}.
        slots:
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user email template
      effect: write
      questions:
      - How do I save a reusable email template for one user?
      - Which templating engines can a template use?
      instructions:
      - text: Create a template named {name} for grant {grant} with subject {subject} and body {body}.
        slots:
          name: requestBody.name
          grant: path.grant_id
          subject: requestBody.subject
          body: requestBody.body
      - text: Save a {engine} template called {name} on {grant} with subject {subject} and HTML {body}.
        slots:
          engine: requestBody.engine
          name: requestBody.name
          grant: path.grant_id
          subject: requestBody.subject
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates/{template_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one user email template
      effect: read
      questions:
      - What's the subject and body of a specific saved template?
      - Can I retrieve a single user template by ID?
      instructions:
      - text: Show template {template} for grant {grant}.
        slots:
          template: path.template_id
          grant: path.grant_id
      - text: Get the contents of template {template} on {grant}.
        slots:
          template: path.template_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates/{template_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a user email template
      effect: write
      questions:
      - Can I change the subject line of an existing template?
      - Is it possible to switch a saved template to a different engine?
      instructions:
      - text: Change the subject of template {template} on {grant} to {subject}.
        slots:
          template: path.template_id
          grant: path.grant_id
          subject: requestBody.subject
      - text: Replace the body of template {template} for grant {grant} with {body}.
        slots:
          template: path.template_id
          grant: path.grant_id
          body: requestBody.body
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates/{template_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user email template
      effect: destructive
      questions:
      - How do I remove a template a user no longer needs?
      - Can I delete a saved template from a grant?
      instructions:
      - text: Delete template {template} from grant {grant}.
        slots:
          template: path.template_id
          grant: path.grant_id
      - text: Remove the saved template {template} on {grant}.
        slots:
          template: path.template_id
          grant: path.grant_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates/{template_id}/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Render a saved template with variables
      effect: read
      questions:
      - What will a saved template look like once I fill in its variables?
      - Can rendering fail if a stored template has variables I didn't supply?
      instructions:
      - text: Render saved template {template} on grant {grant} with variables {variables}.
        slots:
          template: path.template_id
          grant: path.grant_id
          variables: requestBody.variables
      - text: Fill stored template {template} for {grant} using {variables} in strict mode.
        slots:
          template: path.template_id
          grant: path.grant_id
          variables: requestBody.variables
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/grants/{grant_id}/templates/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Render ad-hoc template HTML with variables
      effect: read
      questions:
      - Can I preview raw template HTML with variables without saving it first?
      - How do I test a template body against a specific templating engine?
      instructions:
      - text: Render this HTML {body} with {engine} and variables {variables} for grant {grant}.
        slots:
          body: requestBody.body
          engine: requestBody.engine
          variables: requestBody.variables
          grant: path.grant_id
      - text: Preview unsaved template markup {body} using {engine} on {grant} with {variables}.
        slots:
          body: requestBody.body
          engine: requestBody.engine
          grant: path.grant_id
          variables: requestBody.variables
      method: generated
      generated: '2026-09-26'