Brevo · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Brevo Transactional Email Email Templates API

6 actions 6 updates phrasing extends openapi/brevo-email-templates-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Brevo's API. It is a proposal applied on top of the contract, not a document Brevo publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info

$.paths['/smtp/templates'].get

$.paths['/smtp/templates'].post

$.paths['/smtp/templates/{templateId}'].get

$.paths['/smtp/templates/{templateId}'].put

$.paths['/smtp/templates/{templateId}'].delete

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Brevo Transactional Email Email Templates API
  version: 1.0.0
extends: openapi/brevo-email-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: 5
- target: $.paths['/smtp/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List transactional email templates
      effect: read
      questions:
      - What transactional email templates do I have?
      - Can I list only active email templates?
      instructions:
      - text: List my email templates.
      - text: Show email templates with status {templateStatus}.
        slots:
          templateStatus: query.templateStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/smtp/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a transactional email template
      effect: write
      questions:
      - How do I create a reusable transactional email template?
      - Can an email template include a reply-to address and HTML body?
      instructions:
      - text: Create email template {templateName} from sender {sender}.
        slots:
          templateName: requestBody.templateName
          sender: requestBody.sender
      - text: Create template {templateName} with subject {subject} from {sender}.
        slots:
          templateName: requestBody.templateName
          subject: requestBody.subject
          sender: requestBody.sender
      method: generated
      generated: '2026-09-26'
- target: $.paths['/smtp/templates/{templateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an email template
      effect: read
      questions:
      - What is the subject and content of a specific email template?
      - Can I look up one transactional template by ID?
      instructions:
      - text: Show email template {templateId}.
        slots:
          templateId: path.templateId
      - text: Get the HTML of template {templateId}.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/smtp/templates/{templateId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an email template
      effect: write
      questions:
      - Can I change the subject line of an existing template?
      - Is it possible to deactivate an email template?
      instructions:
      - text: Change the subject of template {templateId} to {subject}.
        slots:
          templateId: path.templateId
          subject: requestBody.subject
      - text: Replace the HTML of template {templateId} with {htmlContent}.
        slots:
          templateId: path.templateId
          htmlContent: requestBody.htmlContent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/smtp/templates/{templateId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email template
      effect: destructive
      questions:
      - Can I permanently delete a transactional email template?
      - Is deleting an email template reversible?
      instructions:
      - text: Delete email template {templateId}.
        slots:
          templateId: path.templateId
      - text: Permanently remove template {templateId}.
        slots:
          templateId: path.templateId
      method: generated
      generated: '2026-09-26'