API Evangelist conversational phrasing for Amazon Simple Service Email API

# 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'


# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amazon-ses/refs/heads/main/overlays/amazon-ses-email-api-phrasing-overlay.yaml