# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Postmark Templates API version: 1.0.0 extends: openapi/postmark-templates-api-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 9 - target: $.paths['/templates/push'].put update: x-apievangelist-phrasing: intent: Copy templates from one server to another effect: write questions: - How do I copy my templates from staging to production? - Can I preview which templates would change before pushing them to another server? instructions: - text: Push templates from server {source_server} to server {destination_server}. slots: source_server: requestBody.SourceServerId destination_server: requestBody.DestinationServerId - text: Dry-run a template push from {source_server} to {destination_server} with perform changes set to {perform_changes}. slots: source_server: requestBody.SourceServerId destination_server: requestBody.DestinationServerId perform_changes: requestBody.PerformChanges method: generated generated: '2026-10-01' - target: $.paths['/email/withTemplate'].post update: x-apievangelist-phrasing: intent: Send one email from a saved template effect: write questions: - How do I send a single message based on a template I've stored? - Can I reference a template by its alias instead of its numeric ID when sending? instructions: - text: Send template {template_alias} to {to} from {from} using model {model}. slots: template_alias: requestBody.TemplateAlias to: requestBody.To from: requestBody.From model: requestBody.TemplateModel - text: Email {to} with template {template_id} and inline the CSS. slots: to: requestBody.To template_id: requestBody.TemplateId method: generated generated: '2026-10-01' - target: $.paths['/email/batchWithTemplates'].post update: x-apievangelist-phrasing: intent: Send many templated emails at once effect: write questions: - Can I send a whole list of template-based emails in one request? - What's the way to bulk-send personalized messages from templates? instructions: - text: 'Batch-send these template messages: {messages}.' slots: messages: requestBody.Messages - text: Send each templated email in {messages} in a single request. slots: messages: requestBody.Messages method: generated generated: '2026-10-01' - target: $.paths['/templates'].get update: x-apievangelist-phrasing: intent: List the server's templates effect: read questions: - Which email templates exist on this server? - Can I page through my templates to find an alias? instructions: - text: List the first {count} templates. slots: count: query.Count - text: Show my templates, skipping {offset}. slots: offset: query.Offset method: generated generated: '2026-10-01' - target: $.paths['/templates'].post update: x-apievangelist-phrasing: intent: Create a template effect: write questions: - How do I create a new email template on my server? - Can I give a new template an alias so I can send by name? instructions: - text: Create a template named {name} with subject {subject}. slots: name: requestBody.Name subject: requestBody.Subject - text: Create template {name} with alias {alias}, subject {subject} and HTML {html_body}. slots: name: requestBody.Name alias: requestBody.Alias subject: requestBody.Subject html_body: requestBody.HtmlBody - text: Add a new text-only template {name} with subject {subject} and body {text_body} on server {server_token}. slots: name: requestBody.Name subject: requestBody.Subject text_body: requestBody.TextBody server_token: header.X-Postmark-Server-Token method: generated generated: '2026-10-01' - target: $.paths['/templates/{templateIdOrAlias}'].get update: x-apievangelist-phrasing: intent: Get a template effect: read questions: - What does the HTML and subject of one of my templates look like? - Can I fetch a template by its alias? instructions: - text: Get template {template}. slots: template: path.templateIdOrAlias - text: Show the subject, HTML and text body of template {template}. slots: template: path.templateIdOrAlias method: generated generated: '2026-10-01' - target: $.paths['/templates/{templateIdOrAlias}'].put update: x-apievangelist-phrasing: intent: Edit a template effect: write questions: - How do I change the subject line of an existing template? - Can I rename a template or give it a new alias? instructions: - text: Change the subject of template {template} to {subject}. slots: template: path.templateIdOrAlias subject: requestBody.Subject - text: Replace the HTML body of template {template} with {html_body}. slots: template: path.templateIdOrAlias html_body: requestBody.HtmlBody - text: Give template {template} the alias {alias}. slots: template: path.templateIdOrAlias alias: requestBody.Alias method: generated generated: '2026-10-01' - target: $.paths['/templates/{templateIdOrAlias}'].delete update: x-apievangelist-phrasing: intent: Delete a template effect: destructive questions: - How do I remove a template I no longer use? - Can I delete a template by its alias? instructions: - text: Delete template {template}. slots: template: path.templateIdOrAlias - text: Remove the template with ID or alias {template}. slots: template: path.templateIdOrAlias method: generated generated: '2026-10-01' - target: $.paths['/templates/validate'].post update: x-apievangelist-phrasing: intent: Validate and preview template content effect: read questions: - Will my template syntax render correctly before I save it? - Can I preview a template's output with sample data? instructions: - text: Validate this template subject {subject} and HTML {html_body}. slots: subject: requestBody.Subject html_body: requestBody.HtmlBody - text: Test-render text body {text_body} with model {render_model}. slots: text_body: requestBody.TextBody render_model: requestBody.TestRenderModel method: generated generated: '2026-10-01'