# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon Simple Service Email API
  version: 1.0.0
extends: openapi/amazon-ses-email-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: 86
- target: $.paths['/v2/email/metrics/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Pull batches of sending metrics
      effect: read
      questions:
      - Can I fetch several sending metric queries, like sends and bounces, in one request?
      - How many metric queries can a single batch request include before it gets throttled?
      instructions:
      - text: 'Run these sending metric queries in one batch: {queries}.'
        slots:
          queries: requestBody.Queries
      - text: Fetch batched delivery and complaint metrics for my sending activity using {queries}.
        slots:
          queries: requestBody.Queries
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets'].get
  update:
    x-apievangelist-phrasing:
      intent: List configuration sets in the region
      effect: read
      questions:
      - Which configuration sets exist on my Amazon SES account in this region?
      - Can I page through all my email configuration sets a few at a time?
      instructions:
      - text: List all of my configuration sets in the current region.
      - text: Show the next {page_size} configuration sets after token {next_token}.
        slots:
          page_size: query.PageSize
          next_token: query.NextToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a configuration set
      effect: write
      questions:
      - How do I create a new group of sending rules to apply to the emails I send?
      - Can I set tracking, reputation and suppression options when I first create a configuration set?
      instructions:
      - text: Create a new configuration set called {name}.
        slots:
          name: requestBody.ConfigurationSetName
      - text: 'Create configuration set {name} with these tags: {tags}.'
        slots:
          name: requestBody.ConfigurationSetName
          tags: requestBody.Tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/event-destinations'].get
  update:
    x-apievangelist-phrasing:
      intent: List a configuration set's event destinations
      effect: read
      questions:
      - Where are the bounce, open and click events for a configuration set being sent?
      - What event destinations are attached to one of my configuration sets?
      instructions:
      - text: Show every event destination attached to configuration set {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      - text: List where send, delivery and complaint events go for {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/event-destinations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add an event destination to a configuration set
      effect: write
      questions:
      - How do I start publishing delivery, bounce and complaint events from a configuration set somewhere new?
      - Can I send open and click events for a configuration set to a new destination?
      instructions:
      - text: Add a new event destination named {destination_name} to configuration set {config_set} using {destination}.
        slots:
          destination_name: requestBody.EventDestinationName
          config_set: path.ConfigurationSetName
          destination: requestBody.EventDestination
      - text: Create event destination {destination_name} on {config_set}.
        slots:
          destination_name: requestBody.EventDestinationName
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}/contacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List the contacts on a contact list
      effect: read
      questions:
      - Who is subscribed to one of my contact lists?
      - Can I filter the contacts on a list, for example by topic subscription?
      instructions:
      - text: List all contacts on contact list {list}.
        slots:
          list: path.ContactListName
      - text: Show contacts on {list} that match {filter}.
        slots:
          list: path.ContactListName
          filter: requestBody.Filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}/contacts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a contact to a contact list
      effect: write
      questions:
      - How do I add a new recipient's email address to one of my contact lists?
      - Can I set a new contact's topic preferences and attributes when adding them to a list?
      instructions:
      - text: Add {email} as a new contact on list {list}.
        slots:
          email: requestBody.EmailAddress
          list: path.ContactListName
      - text: Add {email} to {list} with topic preferences {preferences}.
        slots:
          email: requestBody.EmailAddress
          list: path.ContactListName
          preferences: requestBody.TopicPreferences
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List all contact lists
      effect: read
      questions:
      - What contact lists do I have set up for subscription management?
      - Which mailing lists exist on my account right now?
      instructions:
      - text: List all of my contact lists.
      - text: Show up to {page_size} contact lists.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a contact list
      effect: write
      questions:
      - How do I set up a new contact list with subscription topics?
      - Can a new contact list have a description and tags from the start?
      instructions:
      - text: Create a contact list named {list_name}.
        slots:
          list_name: requestBody.ContactListName
      - text: Create contact list {list_name} with topics {topics} and description {description}.
        slots:
          list_name: requestBody.ContactListName
          topics: requestBody.Topics
          description: requestBody.Description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/custom-verification-email-templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom verification email templates
      effect: read
      questions:
      - Which custom verification email templates have I created in this region?
      - What branded verification emails are available to send to new addresses?
      instructions:
      - text: List my custom verification email templates.
      - text: Show {page_size} custom verification templates starting at token {next_token}.
        slots:
          page_size: query.PageSize
          next_token: query.NextToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/custom-verification-email-templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom verification email template
      effect: write
      questions:
      - Can I brand the email people get when I verify their address, with my own subject and redirect pages?
      - What do I need to supply to build a new custom verification email template?
      instructions:
      - text: Create custom verification template {template} sent from {from} with subject {subject}.
        slots:
          template: requestBody.TemplateName
          from: requestBody.FromEmailAddress
          subject: requestBody.TemplateSubject
      - text: Create verification template {template} that redirects to {success_url} on success and {failure_url} on failure.
        slots:
          template: requestBody.TemplateName
          success_url: requestBody.SuccessRedirectionURL
          failure_url: requestBody.FailureRedirectionURL
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ip-pools'].get
  update:
    x-apievangelist-phrasing:
      intent: List dedicated IP pools
      effect: read
      questions:
      - What dedicated IP pools do I have in this region?
      - Which pools have I grouped my dedicated sending IPs into?
      instructions:
      - text: List all my dedicated IP pools.
      - text: Show the next {page_size} dedicated IP pools.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ip-pools'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a dedicated IP pool
      effect: write
      questions:
      - How do I create a new pool to group my dedicated sending IP addresses?
      - Can a new dedicated IP pool be managed with automatic scaling instead of standard mode?
      instructions:
      - text: Create a dedicated IP pool named {pool}.
        slots:
          pool: requestBody.PoolName
      - text: Create dedicated IP pool {pool} with scaling mode {mode}.
        slots:
          pool: requestBody.PoolName
          mode: requestBody.ScalingMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a predictive inbox placement test
      effect: write
      questions:
      - Can I test whether a message will land in the inbox or spam folder at major mailbox providers before sending it?
      - How would I start a new predictive inbox placement test?
      instructions:
      - text: Start an inbox placement test sending {content} from {from}.
        slots:
          content: requestBody.Content
          from: requestBody.FromEmailAddress
      - text: Run a predictive inbox placement test named {report} from {from} with content {content}.
        slots:
          report: requestBody.ReportName
          from: requestBody.FromEmailAddress
          content: requestBody.Content
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities'].get
  update:
    x-apievangelist-phrasing:
      intent: List verified email addresses and domains
      effect: read
      questions:
      - Which email addresses and domains are registered as sending identities on my account?
      - Can I see every identity I've started verifying, whether or not it succeeded?
      instructions:
      - text: List all of my email identities.
      - text: Show {page_size} email identities starting from token {next_token}.
        slots:
          page_size: query.PageSize
          next_token: query.NextToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities'].post
  update:
    x-apievangelist-phrasing:
      intent: Start verifying an email address or domain
      effect: write
      questions:
      - How do I verify a new domain so I can send email from it?
      - Can I bring my own DKIM key when I add a new sending domain?
      instructions:
      - text: Start verifying {identity} as a sending identity.
        slots:
          identity: requestBody.EmailIdentity
      - text: Add domain {identity} with DKIM signing attributes {dkim} and default configuration set {config_set}.
        slots:
          identity: requestBody.EmailIdentity
          dkim: requestBody.DkimSigningAttributes
          config_set: requestBody.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/policies/{PolicyName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an identity's sending authorization policy
      effect: write
      questions:
      - Can I change an existing sending authorization policy that lets others send from my domain?
      - What happens if I update a sending authorization policy that doesn't exist?
      instructions:
      - text: Replace the existing policy {policy_name} on {identity} with {policy}.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
          policy: requestBody.Policy
      - text: Edit sending authorization policy {policy_name} for identity {identity}.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/policies/{PolicyName}'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a sending authorization policy to an identity
      effect: write
      questions:
      - How do I let another account send email on behalf of my verified domain?
      - Who is allowed to attach a new sending authorization policy to an identity?
      instructions:
      - text: Attach a new sending authorization policy {policy_name} to {identity} with document {policy}.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
          policy: requestBody.Policy
      - text: Create policy {policy_name} on identity {identity} granting delegated sending.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/policies/{PolicyName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a sending authorization policy
      effect: destructive
      questions:
      - Can I revoke someone's permission to send from my domain by removing its policy?
      - Does deleting a sending authorization policy fail if the policy is already gone?
      instructions:
      - text: Delete sending authorization policy {policy_name} from {identity}.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
      - text: Remove the {policy_name} policy on identity {identity}.
        slots:
          policy_name: path.PolicyName
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates'].get
  update:
    x-apievangelist-phrasing:
      intent: List email templates
      effect: read
      questions:
      - Which email templates are saved in my Amazon SES account in this region?
      - Is there a rate limit on listing my email templates?
      instructions:
      - text: List all of my email templates.
      - text: Show {page_size} email templates after token {next_token}.
        slots:
          page_size: query.PageSize
          next_token: query.NextToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an email template
      effect: write
      questions:
      - How do I save a reusable template for personalized emails?
      - Can a new template include a subject line, HTML part and text part?
      instructions:
      - text: Create an email template named {template} with content {content}.
        slots:
          template: requestBody.TemplateName
          content: requestBody.TemplateContent
      - text: Save a new personalized email template {template}.
        slots:
          template: requestBody.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/import-jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List contact import jobs
      effect: read
      questions:
      - What bulk import jobs have I run into my suppression list or contact lists?
      - Can I see only import jobs of one destination type?
      instructions:
      - text: List all my import jobs.
      - text: Show import jobs whose destination type is {type}.
        slots:
          type: requestBody.ImportDestinationType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/import-jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a bulk import job
      effect: write
      questions:
      - How do I bulk import email addresses from a file into a contact list or suppression list?
      - What data source does a new import job need?
      instructions:
      - text: Start an import job from {source} into {destination}.
        slots:
          source: requestBody.ImportDataSource
          destination: requestBody.ImportDestination
      - text: Import the addresses in {source} into destination {destination}.
        slots:
          source: requestBody.ImportDataSource
          destination: requestBody.ImportDestination
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a configuration set's details
      effect: read
      questions:
      - Which dedicated IP pool and reputation settings does one configuration set use?
      - Is sending currently enabled for a particular configuration set?
      instructions:
      - text: Show the details of configuration set {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      - text: Tell me whether {config_set} has sending and reputation tracking enabled.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a configuration set
      effect: destructive
      questions:
      - How do I get rid of a configuration set I no longer apply to my emails?
      - Can I remove an entire configuration set along with its rules?
      instructions:
      - text: Delete configuration set {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      - text: Remove the {config_set} configuration set from my account.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change an event destination's settings
      effect: write
      questions:
      - Can I change which events an existing event destination receives?
      - What would I call to reconfigure an event destination that's already on a configuration set?
      instructions:
      - text: Update event destination {destination_name} on {config_set} to {destination}.
        slots:
          destination_name: path.EventDestinationName
          config_set: path.ConfigurationSetName
          destination: requestBody.EventDestination
      - text: Reconfigure the existing {destination_name} destination in configuration set {config_set}.
        slots:
          destination_name: path.EventDestinationName
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/event-destinations/{EventDestinationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event destination
      effect: destructive
      questions:
      - How do I stop publishing email events to one destination on a configuration set?
      - Can I remove a single event destination without deleting the whole configuration set?
      instructions:
      - text: Delete event destination {destination_name} from configuration set {config_set}.
        slots:
          destination_name: path.EventDestinationName
          config_set: path.ConfigurationSetName
      - text: Stop sending events for {config_set} to {destination_name}.
        slots:
          destination_name: path.EventDestinationName
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one contact on a list
      effect: read
      questions:
      - What topic preferences does a specific subscriber have on one of my lists?
      - Has a particular email address unsubscribed from everything on a contact list?
      instructions:
      - text: Show contact {email} on list {list}.
        slots:
          email: path.EmailAddress
          list: path.ContactListName
      - text: Get the subscription preferences for {email} in {list}.
        slots:
          email: path.EmailAddress
          list: path.ContactListName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a contact's list preferences
      effect: write
      questions:
      - Can I change just one topic preference for an existing contact without resending all of them?
      - How do I mark an existing contact as unsubscribed from all topics?
      instructions:
      - text: Update {email} on list {list} with topic preferences {preferences}.
        slots:
          email: path.EmailAddress
          list: path.ContactListName
          preferences: requestBody.TopicPreferences
      - text: Set unsubscribe-all to {unsubscribe_all} for {email} on {list}.
        slots:
          unsubscribe_all: requestBody.UnsubscribeAll
          email: path.EmailAddress
          list: path.ContactListName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}/contacts/{EmailAddress}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a contact from a list
      effect: destructive
      questions:
      - How do I take one person off a contact list entirely?
      - Can I delete a single contact without affecting the rest of the list?
      instructions:
      - text: Remove {email} from contact list {list}.
        slots:
          email: path.EmailAddress
          list: path.ContactListName
      - text: Delete the contact {email} in {list}.
        slots:
          email: path.EmailAddress
          list: path.ContactListName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contact list's metadata
      effect: read
      questions:
      - What topics and description are defined on one of my contact lists?
      - Does fetching a contact list return its contacts or just its settings?
      instructions:
      - text: Show the topics and description of contact list {list}.
        slots:
          list: path.ContactListName
      - text: Get metadata for the {list} list.
        slots:
          list: path.ContactListName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a contact list's topics and description
      effect: write
      questions:
      - Can I add or rename subscription topics on an existing contact list?
      - Does updating a contact list replace its metadata completely?
      instructions:
      - text: Replace the topics on contact list {list} with {topics}.
        slots:
          list: path.ContactListName
          topics: requestBody.Topics
      - text: Change the description of {list} to {description}.
        slots:
          list: path.ContactListName
          description: requestBody.Description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/contact-lists/{ContactListName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a contact list and its contacts
      effect: destructive
      questions:
      - What happens to the contacts when I delete a whole contact list?
      - How do I remove a mailing list I no longer use?
      instructions:
      - text: Delete contact list {list} and everyone on it.
        slots:
          list: path.ContactListName
      - text: Remove the {list} list permanently.
        slots:
          list: path.ContactListName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/custom-verification-email-templates/{TemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom verification email template
      effect: read
      questions:
      - What subject, sender and redirect URLs does one of my verification templates use?
      - Can I view the content of a specific custom verification email?
      instructions:
      - text: Show custom verification template {template}.
        slots:
          template: path.TemplateName
      - text: Get the content and redirect URLs of verification template {template}.
        slots:
          template: path.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/custom-verification-email-templates/{TemplateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a custom verification email template
      effect: write
      questions:
      - Can I change the redirect pages on a verification template I already created?
      - Which fields must I resend when editing an existing custom verification template?
      instructions:
      - text: Update verification template {template} to send from {from} with subject {subject} and content {content}.
        slots:
          template: path.TemplateName
          from: requestBody.FromEmailAddress
          subject: requestBody.TemplateSubject
          content: requestBody.TemplateContent
      - text: Point existing verification template {template} at {success_url} for success and {failure_url} for failure.
        slots:
          template: path.TemplateName
          success_url: requestBody.SuccessRedirectionURL
          failure_url: requestBody.FailureRedirectionURL
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/custom-verification-email-templates/{TemplateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom verification email template
      effect: destructive
      questions:
      - How do I remove a branded verification email template I no longer need?
      - Can I delete one custom verification template by name?
      instructions:
      - text: Delete custom verification template {template}.
        slots:
          template: path.TemplateName
      - text: Remove the {template} verification email template.
        slots:
          template: path.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ip-pools/{PoolName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dedicated IP pool's details
      effect: read
      questions:
      - Is a particular dedicated IP pool using standard or managed scaling?
      - What can I find out about one dedicated IP pool?
      instructions:
      - text: Show details for dedicated IP pool {pool}.
        slots:
          pool: path.PoolName
      - text: Tell me the scaling mode of pool {pool}.
        slots:
          pool: path.PoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ip-pools/{PoolName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dedicated IP pool
      effect: destructive
      questions:
      - How do I remove a dedicated IP pool I'm no longer sending from?
      - Can I delete a pool of dedicated IPs by its name?
      instructions:
      - text: Delete dedicated IP pool {pool}.
        slots:
          pool: path.PoolName
      - text: Remove the {pool} IP pool.
        slots:
          pool: path.PoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an identity's verification and DKIM status
      effect: read
      questions:
      - Has my domain finished verification, and is DKIM set up correctly?
      - What Mail-From and feedback settings does one sending identity have?
      instructions:
      - text: Show the verification status and DKIM details for {identity}.
        slots:
          identity: path.EmailIdentity
      - text: Check whether identity {identity} is verified.
        slots:
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email address or domain identity
      effect: destructive
      questions:
      - How do I stop using a domain as a sending identity and remove it?
      - Can I delete a verified email address from my account?
      instructions:
      - text: Delete email identity {identity}.
        slots:
          identity: path.EmailIdentity
      - text: Remove the sending domain {identity} from my account.
        slots:
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates/{TemplateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: View an email template
      effect: read
      questions:
      - What subject line, HTML and text are in one of my saved email templates?
      - Can I look at a single email template by name?
      instructions:
      - text: Show email template {template}.
        slots:
          template: path.TemplateName
      - text: Get the subject, HTML and text parts of template {template}.
        slots:
          template: path.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates/{TemplateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an email template
      effect: write
      questions:
      - Can I change the HTML or subject line of a template I already saved?
      - How do I edit an existing personalized email template?
      instructions:
      - text: Update email template {template} with new content {content}.
        slots:
          template: path.TemplateName
          content: requestBody.TemplateContent
      - text: Replace the subject and body of existing template {template} with {content}.
        slots:
          template: path.TemplateName
          content: requestBody.TemplateContent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates/{TemplateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an email template
      effect: destructive
      questions:
      - How do I remove an email template I no longer send?
      - Is there a limit on how quickly I can delete email templates?
      instructions:
      - text: Delete email template {template}.
        slots:
          template: path.TemplateName
      - text: Remove the {template} template from my account.
        slots:
          template: path.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/suppression/addresses/{EmailAddress}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one address on the suppression list
      effect: read
      questions:
      - Why is a particular recipient being suppressed, and when was it added?
      - Is a specific email address on my account's suppression list?
      instructions:
      - text: Look up {email} on my suppression list.
        slots:
          email: path.EmailAddress
      - text: Tell me why {email} is suppressed.
        slots:
          email: path.EmailAddress
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/suppression/addresses/{EmailAddress}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an address from the suppression list
      effect: destructive
      questions:
      - How do I start sending to an address again after it was suppressed for bouncing?
      - Can I take a single recipient off the account suppression list?
      instructions:
      - text: Remove {email} from my suppression list.
        slots:
          email: path.EmailAddress
      - text: Unsuppress {email} so I can email it again.
        slots:
          email: path.EmailAddress
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account'].get
  update:
    x-apievangelist-phrasing:
      intent: Get my account's sending status and limits
      effect: read
      questions:
      - Is my account still in the sandbox, or does it have production access?
      - What's my current sending quota and is sending enabled in this region?
      instructions:
      - text: Show my email account's sending status and capabilities.
      - text: Check whether my account can send email in this region.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/blacklist-report#BlacklistItemNames'].get
  update:
    x-apievangelist-phrasing:
      intent: Check blacklists for my dedicated IPs
      effect: read
      questions:
      - Are any of my dedicated IP addresses on an email blocklist?
      - Which blacklists does a given dedicated IP appear on?
      instructions:
      - text: Show blacklist reports for {items}.
        slots:
          items: query.BlacklistItemNames
      - text: Check whether the dedicated IPs {items} are blacklisted.
        slots:
          items: query.BlacklistItemNames
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ips/{IP}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details for one dedicated IP
      effect: read
      questions:
      - Which pool is a specific dedicated IP in, and how far along is its warm-up?
      - What can I learn about a single dedicated IP address?
      instructions:
      - text: Show details for dedicated IP {ip}.
        slots:
          ip: path.IP
      - text: Tell me the pool and warm-up status of {ip}.
        slots:
          ip: path.IP
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ips'].get
  update:
    x-apievangelist-phrasing:
      intent: List dedicated IP addresses
      effect: read
      questions:
      - What dedicated IP addresses are associated with my account?
      - Can I list only the dedicated IPs in one pool?
      instructions:
      - text: List all my dedicated IP addresses.
      - text: List the dedicated IPs in pool {pool}.
        slots:
          pool: query.PoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the Deliverability dashboard status
      effect: read
      questions:
      - Is the Deliverability dashboard turned on for my account, and which domains does it cover?
      - When does my Deliverability dashboard subscription expire?
      instructions:
      - text: Show the status of my Deliverability dashboard.
      - text: List the domains subscribed to the Deliverability dashboard.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn the Deliverability dashboard on or off
      effect: write
      questions:
      - How do I enable the Deliverability dashboard to get reputation and inbox placement data?
      - Can I choose which domains the Deliverability dashboard tracks?
      instructions:
      - text: Set the Deliverability dashboard enabled flag to {enabled}.
        slots:
          enabled: requestBody.DashboardEnabled
      - text: Enable the Deliverability dashboard ({enabled}) for domains {domains}.
        slots:
          enabled: requestBody.DashboardEnabled
          domains: requestBody.SubscribedDomains
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/test-reports/{ReportId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get inbox placement test results
      effect: read
      questions:
      - What were the inbox versus spam results of a placement test I ran?
      - Can I see the outcome of one predictive inbox placement test by its ID?
      instructions:
      - text: Show the results of inbox placement test {report_id}.
        slots:
          report_id: path.ReportId
      - text: Get the placement report for test {report_id}.
        slots:
          report_id: path.ReportId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/campaigns/{CampaignId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get deliverability data for one campaign
      effect: read
      questions:
      - What were the inbox rate and engagement numbers for a specific email campaign?
      - Which campaigns have deliverability data available?
      instructions:
      - text: Show deliverability data for campaign {campaign}.
        slots:
          campaign: path.CampaignId
      - text: Get the inbox placement stats of campaign {campaign}.
        slots:
          campaign: path.CampaignId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/statistics-report/{Domain}#StartDate&EndDate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get inbox placement stats for a sending domain
      effect: read
      questions:
      - What were the inbox placement and engagement rates for my sending domain last month?
      - Can I get daily domain deliverability statistics for a date range?
      instructions:
      - text: Show inbox placement and engagement rates for {domain} from {start} to {end}.
        slots:
          domain: path.Domain
          start: query.StartDate
          end: query.EndDate
      - text: Get the domain statistics report for {domain} between {start} and {end}.
        slots:
          domain: path.Domain
          start: query.StartDate
          end: query.EndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/policies'].get
  update:
    x-apievangelist-phrasing:
      intent: List an identity's sending authorization policies
      effect: read
      questions:
      - Which sending authorization policies are attached to my domain?
      - Who have I authorized to send on behalf of a given email address?
      instructions:
      - text: List the sending authorization policies on {identity}.
        slots:
          identity: path.EmailIdentity
      - text: Show all policy documents attached to identity {identity}.
        slots:
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/import-jobs/{JobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an import job's status
      effect: read
      questions:
      - Has my bulk contact import finished, and how many records failed?
      - What details can I see for a single import job?
      instructions:
      - text: Show the status of import job {job_id}.
        slots:
          job_id: path.JobId
      - text: Get the progress of import {job_id}.
        slots:
          job_id: path.JobId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/test-reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List inbox placement tests
      effect: read
      questions:
      - Which predictive inbox placement tests have I run so far?
      - Does the list of placement tests include ones still in progress?
      instructions:
      - text: List all my inbox placement tests.
      - text: Show {page_size} placement test reports.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/deliverability-dashboard/domains/{SubscribedDomain}/campaigns#StartDate&EndDate'].get
  update:
    x-apievangelist-phrasing:
      intent: List campaigns sent from a domain
      effect: read
      questions:
      - Which campaigns went out from my subscribed domain during a given period?
      - Can I get deliverability data for every campaign a domain sent in a time range?
      instructions:
      - text: List campaigns sent from {domain} between {start} and {end}.
        slots:
          domain: path.SubscribedDomain
          start: query.StartDate
          end: query.EndDate
      - text: Show deliverability for all {domain} campaigns from {start} to {end}.
        slots:
          domain: path.SubscribedDomain
          start: query.StartDate
          end: query.EndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/vdm/recommendations'].post
  update:
    x-apievangelist-phrasing:
      intent: List Virtual Deliverability Manager recommendations
      effect: read
      questions:
      - What deliverability recommendations does Virtual Deliverability Manager have for my account?
      - Can I filter recommendations, for instance by type or status?
      instructions:
      - text: List my deliverability recommendations.
      - text: Show recommendations matching {filter}.
        slots:
          filter: requestBody.Filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/suppression/addresses'].get
  update:
    x-apievangelist-phrasing:
      intent: List suppressed email addresses
      effect: read
      questions:
      - Which addresses are on my suppression list because they bounced or complained?
      - Can I list only addresses suppressed within a certain date range?
      instructions:
      - text: List every address on my suppression list.
      - text: Show addresses suppressed for {reason} between {start} and {end}.
        slots:
          reason: query.Reason
          start: query.StartDate
          end: query.EndDate
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/suppression/addresses'].put
  update:
    x-apievangelist-phrasing:
      intent: Add an address to the suppression list
      effect: write
      questions:
      - How do I stop my account from ever sending to a certain address?
      - What reasons can I give when manually suppressing a recipient?
      instructions:
      - text: Add {email} to my suppression list for reason {reason}.
        slots:
          email: requestBody.EmailAddress
          reason: requestBody.Reason
      - text: Suppress {email} as a {reason}.
        slots:
          email: requestBody.EmailAddress
          reason: requestBody.Reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/tags#ResourceArn'].get
  update:
    x-apievangelist-phrasing:
      intent: List a resource's tags
      effect: read
      questions:
      - What tags are on one of my email resources?
      - Can I see the key-value labels attached to a configuration set or identity?
      instructions:
      - text: List the tags on resource {arn}.
        slots:
          arn: query.ResourceArn
      - text: Show all tag keys and values for {arn}.
        slots:
          arn: query.ResourceArn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account/dedicated-ips/warmup'].put
  update:
    x-apievangelist-phrasing:
      intent: Toggle automatic warm-up for dedicated IPs
      effect: write
      questions:
      - Can I turn off automatic warm-up for all my dedicated IP addresses at the account level?
      - Where do I enable automatic IP warm-up for new dedicated IPs?
      instructions:
      - text: Set account-wide automatic dedicated IP warm-up to {enabled}.
        slots:
          enabled: requestBody.AutoWarmupEnabled
      - text: Turn on automatic warm-up for my dedicated IPs.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account/details'].post
  update:
    x-apievangelist-phrasing:
      intent: Update account details and request production access
      effect: write
      questions:
      - How do I request to move my account out of the sandbox into production?
      - What use case details do I have to provide about my email sending?
      instructions:
      - text: 'Update my account details: mail type {mail_type}, website {website}, use case {use_case}.'
        slots:
          mail_type: requestBody.MailType
          website: requestBody.WebsiteURL
          use_case: requestBody.UseCaseDescription
      - text: Request production access for {mail_type} email from {website} describing {use_case}.
        slots:
          mail_type: requestBody.MailType
          website: requestBody.WebsiteURL
          use_case: requestBody.UseCaseDescription
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account/sending'].put
  update:
    x-apievangelist-phrasing:
      intent: Pause or resume sending for the account
      effect: write
      questions:
      - Can I pause all email sending from my account in this region?
      - How would I re-enable sending for my whole account?
      instructions:
      - text: Set account-wide sending enabled to {enabled}.
        slots:
          enabled: requestBody.SendingEnabled
      - text: Pause email sending for my entire account.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account/suppression'].put
  update:
    x-apievangelist-phrasing:
      intent: Set account suppression list reasons
      effect: write
      questions:
      - Can my account automatically suppress addresses that bounce or complain?
      - Which reasons add an address to the account-level suppression list?
      instructions:
      - text: Set my account suppression list to suppress on {reasons}.
        slots:
          reasons: requestBody.SuppressedReasons
      - text: Automatically suppress bounces and complaints at the account level.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/account/vdm'].put
  update:
    x-apievangelist-phrasing:
      intent: Update account Virtual Deliverability Manager settings
      effect: write
      questions:
      - How do I turn on Virtual Deliverability Manager for my whole account?
      - Can I enable engagement tracking and optimized shared delivery account-wide?
      instructions:
      - text: Set my account's VDM attributes to {vdm}.
        slots:
          vdm: requestBody.VdmAttributes
      - text: Enable Virtual Deliverability Manager on my account with {vdm}.
        slots:
          vdm: requestBody.VdmAttributes
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/delivery-options'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign an IP pool and TLS policy to a configuration set
      effect: write
      questions:
      - Can I make emails sent with one configuration set go out through a specific dedicated IP pool?
      - Is it possible to require TLS for messages using a configuration set?
      instructions:
      - text: Send mail for configuration set {config_set} through IP pool {pool}.
        slots:
          config_set: path.ConfigurationSetName
          pool: requestBody.SendingPoolName
      - text: Set the TLS policy for {config_set} to {tls}.
        slots:
          config_set: path.ConfigurationSetName
          tls: requestBody.TlsPolicy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/reputation-options'].put
  update:
    x-apievangelist-phrasing:
      intent: Toggle reputation metrics for a configuration set
      effect: write
      questions:
      - Can I collect bounce and complaint reputation metrics for one configuration set only?
      - How do I stop tracking reputation for a particular configuration set?
      instructions:
      - text: Set reputation metrics collection for {config_set} to {enabled}.
        slots:
          config_set: path.ConfigurationSetName
          enabled: requestBody.ReputationMetricsEnabled
      - text: Turn on reputation metrics for configuration set {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/sending'].put
  update:
    x-apievangelist-phrasing:
      intent: Pause or resume sending for a configuration set
      effect: write
      questions:
      - Can I pause only the emails that use one configuration set, without stopping the whole account?
      - What's the way to resume sending for a paused configuration set?
      instructions:
      - text: Set sending enabled for configuration set {config_set} to {enabled}.
        slots:
          config_set: path.ConfigurationSetName
          enabled: requestBody.SendingEnabled
      - text: Pause sending for messages using {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/suppression-options'].put
  update:
    x-apievangelist-phrasing:
      intent: Set suppression preferences for a configuration set
      effect: write
      questions:
      - Can one configuration set override which reasons trigger suppression?
      - How do I make a configuration set ignore complaints for suppression purposes?
      instructions:
      - text: Set suppression reasons for configuration set {config_set} to {reasons}.
        slots:
          config_set: path.ConfigurationSetName
          reasons: requestBody.SuppressedReasons
      - text: Override account suppression settings on {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/tracking-options'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a custom domain for open and click tracking
      effect: write
      questions:
      - Can I use my own domain for open and click tracking links?
      - Where do I configure a custom redirect domain for a configuration set?
      instructions:
      - text: Use {domain} as the open and click tracking domain for {config_set}.
        slots:
          domain: requestBody.CustomRedirectDomain
          config_set: path.ConfigurationSetName
      - text: Set custom tracking redirect domain on configuration set {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/configuration-sets/{ConfigurationSetName}/vdm-options'].put
  update:
    x-apievangelist-phrasing:
      intent: Set VDM options for a configuration set
      effect: write
      questions:
      - Can I override Virtual Deliverability Manager settings for just one configuration set?
      - How often can I change VDM preferences on a configuration set?
      instructions:
      - text: Apply VDM options {vdm} to configuration set {config_set}.
        slots:
          vdm: requestBody.VdmOptions
          config_set: path.ConfigurationSetName
      - text: Update Virtual Deliverability Manager preferences on {config_set}.
        slots:
          config_set: path.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ips/{IP}/pool'].put
  update:
    x-apievangelist-phrasing:
      intent: Move a dedicated IP to another pool
      effect: write
      questions:
      - How do I move one of my dedicated IPs into a different pool?
      - Does the destination pool have to exist before I move an IP into it?
      instructions:
      - text: Move dedicated IP {ip} into pool {pool}.
        slots:
          ip: path.IP
          pool: requestBody.DestinationPoolName
      - text: Reassign {ip} to the {pool} pool.
        slots:
          ip: path.IP
          pool: requestBody.DestinationPoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/dedicated-ips/{IP}/warmup'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the warm-up percentage for a dedicated IP
      effect: write
      questions:
      - Can I manually set how far along a single dedicated IP is in its warm-up?
      - What warm-up percentage is a specific dedicated IP at, and can I change it?
      instructions:
      - text: Set the warm-up percentage of dedicated IP {ip} to {percent}.
        slots:
          ip: path.IP
          percent: requestBody.WarmupPercentage
      - text: Mark {ip} as {percent} percent warmed up.
        slots:
          ip: path.IP
          percent: requestBody.WarmupPercentage
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/configuration-set'].put
  update:
    x-apievangelist-phrasing:
      intent: Set an identity's default configuration set
      effect: write
      questions:
      - Can every email sent from one domain automatically use a certain configuration set?
      - How do I attach a default configuration set to an existing identity?
      instructions:
      - text: Make {config_set} the default configuration set for {identity}.
        slots:
          config_set: requestBody.ConfigurationSetName
          identity: path.EmailIdentity
      - text: Associate identity {identity} with configuration set {config_set}.
        slots:
          identity: path.EmailIdentity
          config_set: requestBody.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/dkim'].put
  update:
    x-apievangelist-phrasing:
      intent: Turn DKIM signing on or off for an identity
      effect: write
      questions:
      - Can I temporarily disable DKIM signing for one of my domains?
      - How do I switch DKIM signing back on for an identity?
      instructions:
      - text: Set DKIM signing for {identity} to {enabled}.
        slots:
          identity: path.EmailIdentity
          enabled: requestBody.SigningEnabled
      - text: Enable DKIM signing on identity {identity}.
        slots:
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/email/identities/{EmailIdentity}/dkim/signing'].put
  update:
    x-apievangelist-phrasing:
      intent: Change DKIM key settings for a domain
      effect: write
      questions:
      - Can I switch a domain from Easy DKIM to my own DKIM key, or back again?
      - Is it possible to rotate the DKIM key length for a domain identity?
      instructions:
      - text: Set the DKIM signing origin for domain {identity} to {origin}.
        slots:
          identity: path.EmailIdentity
          origin: requestBody.SigningAttributesOrigin
      - text: Use my own DKIM key {attributes} for {identity} with origin {origin}.
        slots:
          attributes: requestBody.SigningAttributes
          identity: path.EmailIdentity
          origin: requestBody.SigningAttributesOrigin
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/feedback'].put
  update:
    x-apievangelist-phrasing:
      intent: Toggle bounce and complaint email forwarding
      effect: write
      questions:
      - Can I stop getting bounce and complaint notifications by email for one identity?
      - What happens to feedback forwarding when I send from a particular address?
      instructions:
      - text: Set feedback forwarding for {identity} to {enabled}.
        slots:
          identity: path.EmailIdentity
          enabled: requestBody.EmailForwardingEnabled
      - text: Turn off bounce and complaint email forwarding for {identity}.
        slots:
          identity: path.EmailIdentity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/identities/{EmailIdentity}/mail-from'].put
  update:
    x-apievangelist-phrasing:
      intent: Configure a custom Mail-From domain
      effect: write
      questions:
      - How do I send with a custom MAIL FROM domain instead of the default one?
      - What happens if the MX record for my custom Mail-From domain fails?
      instructions:
      - text: Set the custom Mail-From domain for {identity} to {mail_from}.
        slots:
          identity: path.EmailIdentity
          mail_from: requestBody.MailFromDomain
      - text: Use Mail-From domain {mail_from} on {identity} with MX failure behavior {behavior}.
        slots:
          mail_from: requestBody.MailFromDomain
          identity: path.EmailIdentity
          behavior: requestBody.BehaviorOnMxFailure
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/outbound-bulk-emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a templated email to many recipients
      effect: write
      questions:
      - Can I send one templated message to a batch of recipients with per-recipient data in a single call?
      - How do I do a bulk email send with default content and individual destinations?
      instructions:
      - text: 'Send a bulk email using {content} to these entries: {entries}.'
        slots:
          content: requestBody.DefaultContent
          entries: requestBody.BulkEmailEntries
      - text: Bulk send {content} from {from} to {entries}.
        slots:
          content: requestBody.DefaultContent
          from: requestBody.FromEmailAddress
          entries: requestBody.BulkEmailEntries
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/outbound-custom-verification-emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a custom verification email to an address
      effect: write
      questions:
      - Can I verify a new sender address using my own branded verification email?
      - What happens when I send a custom verification email to someone?
      instructions:
      - text: Send verification template {template} to {email}.
        slots:
          template: requestBody.TemplateName
          email: requestBody.EmailAddress
      - text: Verify {email} with my custom verification email {template}.
        slots:
          email: requestBody.EmailAddress
          template: requestBody.TemplateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/outbound-emails'].post
  update:
    x-apievangelist-phrasing:
      intent: Send an email message
      effect: write
      questions:
      - How do I send a single email with Amazon SES?
      - Can I send a raw MIME message or a templated email, not just a simple one?
      - Can I tag an outgoing message and include list unsubscribe options?
      instructions:
      - text: Send an email from {from} to {destination} with content {content}.
        slots:
          from: requestBody.FromEmailAddress
          destination: requestBody.Destination
          content: requestBody.Content
      - text: Send {content} to {destination} using configuration set {config_set}.
        slots:
          content: requestBody.Content
          destination: requestBody.Destination
          config_set: requestBody.ConfigurationSetName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Add tags to a resource
      effect: write
      questions:
      - Can I label an email identity or configuration set with tags for cost tracking?
      - How do I attach key-value tags to one of my resources?
      instructions:
      - text: Tag resource {arn} with {tags}.
        slots:
          arn: requestBody.ResourceArn
          tags: requestBody.Tags
      - text: Add tags {tags} to {arn}.
        slots:
          tags: requestBody.Tags
          arn: requestBody.ResourceArn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/templates/{TemplateName}/render'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a rendered email template
      effect: read
      questions:
      - Can I preview how a template renders with sample replacement data before sending it?
      - What does the MIME output of a template look like filled in with test values?
      instructions:
      - text: Render template {template} with data {data}.
        slots:
          template: path.TemplateName
          data: requestBody.TemplateData
      - text: Preview {template} filled in with {data}.
        slots:
          template: path.TemplateName
          data: requestBody.TemplateData
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/email/tags#ResourceArn&TagKeys'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove tags from a resource
      effect: destructive
      questions:
      - How do I strip specific tags off an email resource?
      - Can I remove several tag keys from a resource at once?
      instructions:
      - text: Remove tags {keys} from resource {arn}.
        slots:
          keys: query.TagKeys
          arn: query.ResourceArn
      - text: Untag {arn} by deleting keys {keys}.
        slots:
          arn: query.ResourceArn
          keys: query.TagKeys
      method: generated
      generated: '2026-09-26'