# 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 Microsoft.Support Communications API
  version: 1.0.0
extends: openapi/microsoft-azure-communications-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: 8
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a new ticket message name is free
      effect: read
      questions:
      - Before adding a message to my support ticket, how can I check the communication name is unique?
      - Is a proposed communication name already used on a subscription support ticket?
      instructions:
      - text: Check whether communication name {name} of type {type} is available on ticket {ticket} in subscription {subscription_id}.
        slots:
          name: requestBody.name
          type: requestBody.type
          ticket: path.supportTicketName
          subscription_id: path.subscriptionId
      - text: Verify {name} is unused on subscription support ticket {ticket}.
        slots:
          name: requestBody.name
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a message name on a tenant-level ticket
      effect: read
      questions:
      - How do I check a communication name is unique on a support ticket that isn't tied to a subscription?
      - Can I validate a message name for a tenant-level support ticket?
      instructions:
      - text: Check if communication name {name} of type {type} is free on tenant-level ticket {ticket}.
        slots:
          name: requestBody.name
          type: requestBody.type
          ticket: path.supportTicketName
      - text: Validate name {name} for a new message on no-subscription ticket {ticket}.
        slots:
          name: requestBody.name
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications'].get
  update:
    x-apievangelist-phrasing:
      intent: List messages on a subscription support ticket
      effect: read
      questions:
      - What messages have been exchanged on my Azure support ticket?
      - Can I filter ticket messages by created date or communication type?
      instructions:
      - text: List the communications on support ticket {ticket} in subscription {subscription_id}.
        slots:
          ticket: path.supportTicketName
          subscription_id: path.subscriptionId
      - text: Show the latest {top} messages on ticket {ticket} in my subscription.
        slots:
          top: query.$top
          ticket: path.supportTicketName
      - text: List ticket {ticket} messages matching {filter}.
        slots:
          ticket: path.supportTicketName
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications'].get
  update:
    x-apievangelist-phrasing:
      intent: List messages on a tenant-level support ticket
      effect: read
      questions:
      - How do I read the conversation on a support ticket opened without a subscription?
      - Can I filter tenant-level ticket messages by type?
      instructions:
      - text: List communications on tenant-level support ticket {ticket}.
        slots:
          ticket: path.supportTicketName
      - text: Show the first {top} messages on no-subscription ticket {ticket}.
        slots:
          top: query.$top
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one message on a subscription support ticket
      effect: read
      questions:
      - What did a specific message on my subscription support ticket say?
      - Can I pull the details of one support communication by name?
      instructions:
      - text: Show communication {communication} on ticket {ticket} in subscription {subscription_id}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
          subscription_id: path.subscriptionId
      - text: Get message {communication} from subscription ticket {ticket}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Reply on a subscription support ticket
      effect: write
      questions:
      - How do I add a reply to an open Azure support ticket in my subscription?
      - Can I post a new customer message to a support case via the API?
      instructions:
      - text: Add communication {communication} to ticket {ticket} in subscription {subscription_id} with content {properties}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
          subscription_id: path.subscriptionId
          properties: requestBody.properties
      - text: Post a reply named {communication} on my subscription support ticket {ticket}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one message on a tenant-level ticket
      effect: read
      questions:
      - How do I read a single message on a support ticket not linked to a subscription?
      - Can I get one communication from a tenant-level support case?
      instructions:
      - text: Show communication {communication} on tenant-level ticket {ticket}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
      - text: Get message {communication} from no-subscription support ticket {ticket}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}/communications/{communicationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Reply on a tenant-level support ticket
      effect: write
      questions:
      - How do I reply to a support ticket that was opened at tenant level, without a subscription?
      - Can I add a customer message to a no-subscription support case?
      instructions:
      - text: Add communication {communication} to tenant-level ticket {ticket} with content {properties}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
          properties: requestBody.properties
      - text: Post reply {communication} on no-subscription ticket {ticket}.
        slots:
          communication: path.communicationName
          ticket: path.supportTicketName
      method: generated
      generated: '2026-09-26'