# 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 Billing benefits RP Savings Plan Order API
  version: 1.0.0
extends: openapi/microsoft-azure-savings-plan-order-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: 3
- target: $.paths['/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a savings plan order
      effect: read
      questions:
      - How do I see the details of one Azure savings plan order?
      - Can I expand a savings plan order to include its schedule?
      instructions:
      - text: Show savings plan order {savingsPlanOrderId}.
        slots:
          savingsPlanOrderId: path.savingsPlanOrderId
      - text: Get savings plan order {savingsPlanOrderId} expanded with {expand}.
        slots:
          savingsPlanOrderId: path.savingsPlanOrderId
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.BillingBenefits/savingsPlanOrders/{savingsPlanOrderId}/elevate'].post
  update:
    x-apievangelist-phrasing:
      intent: Elevate to owner on a savings plan order
      effect: write
      questions:
      - How do I make myself owner of a savings plan order using my billing permissions?
      - Can a billing admin take ownership of a savings plan order?
      instructions:
      - text: Elevate me to owner on savings plan order {savingsPlanOrderId}.
        slots:
          savingsPlanOrderId: path.savingsPlanOrderId
      - text: Grant owner access on order {savingsPlanOrderId} based on my billing role.
        slots:
          savingsPlanOrderId: path.savingsPlanOrderId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.BillingBenefits/savingsPlanOrders'].get
  update:
    x-apievangelist-phrasing:
      intent: List savings plan orders
      effect: read
      questions:
      - Which savings plan orders do I have access to?
      - Can I see all of my Azure savings plan purchases in one list?
      instructions:
      - text: List all my savings plan orders using API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show every savings plan order I can see.
      method: generated
      generated: '2026-09-26'