# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Communication Services Management…
  version: 1.0.0
extends: openapi/microsoft-azure-suppressionlists-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists'].get
  update:
    x-apievangelist-phrasing:
      intent: List suppression lists on an email domain
      effect: read
      questions:
      - Which email suppression lists are set up on my Communication Services domain?
      - Can I see every suppression list attached to one sending domain?
      instructions:
      - text: List the suppression lists on email domain {domainName}.
        slots:
          domainName: path.domainName
      - text: Show all suppression lists configured for {domainName} under email service {emailServiceName}.
        slots:
          domainName: path.domainName
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a suppression list
      effect: read
      questions:
      - How do I look up the settings of one suppression list on my email domain?
      - What sender username does a particular suppression list apply to?
      instructions:
      - text: Get suppression list {suppressionListName} on domain {domainName}.
        slots:
          suppressionListName: path.suppressionListName
          domainName: path.domainName
      - text: Show the configuration of the {suppressionListName} suppression list in email service {emailServiceName}.
        slots:
          suppressionListName: path.suppressionListName
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a suppression list
      effect: write
      questions:
      - How do I create a suppression list so certain recipients stop receiving my emails?
      - Can I change the properties of an existing suppression list on a domain?
      instructions:
      - text: Create suppression list {suppressionListName} on domain {domainName} of email service {emailServiceName}.
        slots:
          suppressionListName: path.suppressionListName
          domainName: path.domainName
          emailServiceName: path.emailServiceName
      - text: Update suppression list {suppressionListName} on {domainName} with {properties}.
        slots:
          suppressionListName: path.suppressionListName
          domainName: path.domainName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a suppression list
      effect: destructive
      questions:
      - How do I delete an entire suppression list from my email domain?
      - Can I drop a suppression list I no longer use?
      instructions:
      - text: Delete suppression list {suppressionListName} from domain {domainName}.
        slots:
          suppressionListName: path.suppressionListName
          domainName: path.domainName
      - text: Remove the whole {suppressionListName} list from email service {emailServiceName}.
        slots:
          suppressionListName: path.suppressionListName
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}/suppressionListAddresses'].get
  update:
    x-apievangelist-phrasing:
      intent: List addresses in a suppression list
      effect: read
      questions:
      - Which email addresses are currently on my suppression list?
      - Can I see everyone who is blocked from receiving mail via a given suppression list?
      instructions:
      - text: List the addresses in suppression list {suppressionListName} on {domainName}.
        slots:
          suppressionListName: path.suppressionListName
          domainName: path.domainName
      - text: Show every suppressed recipient in {suppressionListName} for email service {emailServiceName}.
        slots:
          suppressionListName: path.suppressionListName
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}/suppressionListAddresses/{addressId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one suppressed email address
      effect: read
      questions:
      - How do I check the details of a single address on a suppression list?
      - When was a particular recipient added to my suppression list, and why?
      instructions:
      - text: Get address {addressId} from suppression list {suppressionListName} on {domainName}.
        slots:
          addressId: path.addressId
          suppressionListName: path.suppressionListName
          domainName: path.domainName
      - text: Show suppressed address entry {addressId} in email service {emailServiceName}.
        slots:
          addressId: path.addressId
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}/suppressionListAddresses/{addressId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update an address on a suppression list
      effect: write
      questions:
      - How do I block a specific recipient by adding them to a suppression list?
      - Can I edit the notes on an address that's already suppressed?
      instructions:
      - text: Add address {addressId} to suppression list {suppressionListName} on {domainName} with {properties}.
        slots:
          addressId: path.addressId
          suppressionListName: path.suppressionListName
          domainName: path.domainName
          properties: requestBody.properties
      - text: Update suppressed address {addressId} in {suppressionListName} of email service {emailServiceName}.
        slots:
          addressId: path.addressId
          suppressionListName: path.suppressionListName
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/emailServices/{emailServiceName}/domains/{domainName}/suppressionLists/{suppressionListName}/suppressionListAddresses/{addressId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an address from a suppression list
      effect: destructive
      questions:
      - How do I unsuppress one recipient so they can receive my emails again?
      - Can I take a single address off a suppression list without touching the rest?
      instructions:
      - text: Remove address {addressId} from suppression list {suppressionListName} on {domainName}.
        slots:
          addressId: path.addressId
          suppressionListName: path.suppressionListName
          domainName: path.domainName
      - text: Unsuppress entry {addressId} in email service {emailServiceName}.
        slots:
          addressId: path.addressId
          emailServiceName: path.emailServiceName
      method: generated
      generated: '2026-10-01'