# 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 Support Tickets API
  version: 1.0.0
extends: openapi/microsoft-azure-support-tickets-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a support ticket name within a subscription
      effect: read
      questions:
      - Is a support ticket name already used in my subscription?
      - Can I confirm a ticket name is unique for one subscription before filing?
      instructions:
      - text: Check if support ticket name {name} is available in subscription {subscriptionId}.
        slots:
          name: requestBody.name
          subscriptionId: path.subscriptionId
      - text: Validate ticket name {name} of type {type} for subscription {subscriptionId}.
        slots:
          name: requestBody.name
          type: requestBody.type
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Support/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a support ticket name at tenant level
      effect: read
      questions:
      - Can I check a ticket name's availability without picking a subscription?
      - Is this name free for a tenant-level billing ticket?
      instructions:
      - text: Check tenant-wide whether support ticket name {name} is available.
        slots:
          name: requestBody.name
      - text: Validate ticket name {name} of type {type} without a subscription scope.
        slots:
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets'].get
  update:
    x-apievangelist-phrasing:
      intent: List support tickets for a subscription
      effect: read
      questions:
      - What support tickets are open on my Azure subscription?
      - Can I filter a subscription's tickets by status or creation date?
      - How long is support ticket history kept?
      instructions:
      - text: List support tickets for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show the {top} tickets in subscription {subscriptionId} matching {filter}.
        slots:
          top: query.$top
          subscriptionId: path.subscriptionId
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Support/supportTickets'].get
  update:
    x-apievangelist-phrasing:
      intent: List support tickets across the tenant
      effect: read
      questions:
      - Which billing and subscription-management tickets have I filed without a subscription?
      - Can I list tenant-level support tickets filtered by status?
      instructions:
      - text: List my tenant-level support tickets.
      - text: Show {top} tenant support tickets that match {filter}.
        slots:
          top: query.$top
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a support ticket in a subscription
      effect: read
      questions:
      - What is the current status of a support ticket on my subscription?
      - Can I still see a ticket that was opened two years ago?
      instructions:
      - text: Get support ticket {supportTicketName} in subscription {subscriptionId}.
        slots:
          supportTicketName: path.supportTicketName
          subscriptionId: path.subscriptionId
      - text: Show severity and status of subscription ticket {supportTicketName}.
        slots:
          supportTicketName: path.supportTicketName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Open a support ticket for a subscription
      effect: write
      questions:
      - How do I request a quota increase through a support ticket?
      - Can I open a technical support case against a specific subscription?
      instructions:
      - text: Open support ticket {supportTicketName} on subscription {subscriptionId}.
        slots:
          supportTicketName: path.supportTicketName
          subscriptionId: path.subscriptionId
      - text: File quota ticket {supportTicketName} for subscription {subscriptionId} with details {properties}.
        slots:
          supportTicketName: path.supportTicketName
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/supportTickets/{supportTicketName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a support ticket in a subscription
      effect: write
      questions:
      - Can I raise the severity of a subscription support ticket?
      - How do I close a ticket or give advanced diagnostic consent on my subscription case?
      - Why can't I change severity while an engineer is working the ticket?
      instructions:
      - text: Set severity of ticket {supportTicketName} in subscription {subscriptionId} to {severity}.
        slots:
          supportTicketName: path.supportTicketName
          subscriptionId: path.subscriptionId
          severity: requestBody.severity
      - text: Mark subscription ticket {supportTicketName} as {status}.
        slots:
          supportTicketName: path.supportTicketName
          status: requestBody.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tenant-level support ticket
      effect: read
      questions:
      - Where can I check a billing ticket that isn't tied to a subscription?
      - What details does a tenant-level ticket show?
      instructions:
      - text: Get tenant-level support ticket {supportTicketName}.
        slots:
          supportTicketName: path.supportTicketName
      - text: Show the status of non-subscription ticket {supportTicketName}.
        slots:
          supportTicketName: path.supportTicketName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Open a billing or subscription-management ticket
      effect: write
      questions:
      - How do I file a billing ticket without choosing a subscription?
      - Can I open a subscription-management case at tenant level?
      instructions:
      - text: Open tenant-level billing ticket {supportTicketName}.
        slots:
          supportTicketName: path.supportTicketName
      - text: File subscription-management ticket {supportTicketName} with details {properties}, no subscription scope.
        slots:
          supportTicketName: path.supportTicketName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Support/supportTickets/{supportTicketName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tenant-level support ticket
      effect: write
      questions:
      - Can I update my contact details on a billing ticket with no subscription?
      - How do I change the severity of a tenant-level case?
      instructions:
      - text: Set severity of tenant-level ticket {supportTicketName} to {severity}.
        slots:
          supportTicketName: path.supportTicketName
          severity: requestBody.severity
      - text: Update contact info on non-subscription ticket {supportTicketName} to {contactDetails}.
        slots:
          supportTicketName: path.supportTicketName
          contactDetails: requestBody.contactDetails
      method: generated
      generated: '2026-10-01'