# 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 ConsumptionManagementClient Balances API
  version: 1.0.0
extends: openapi/microsoft-azure-balances-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: 2
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Consumption/balances'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current balance of a billing account
      effect: read
      questions:
      - How do I see my Azure billing account's current balance and credits?
      - How far back is balance data available for a billing account?
      instructions:
      - text: Get the balance for billing account {billingAccountId}.
        slots:
          billingAccountId: path.billingAccountId
      - text: Show current balances and credits on billing account {billingAccountId}.
        slots:
          billingAccountId: path.billingAccountId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/balances'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a billing account balance for a period
      effect: read
      questions:
      - Can I see what my billing account balance was for a past billing period?
      - What balance, adjustments and charges were recorded for a specific billing period?
      instructions:
      - text: Get the balance for billing account {billingAccountId} in billing period {billingPeriodName}.
        slots:
          billingAccountId: path.billingAccountId
          billingPeriodName: path.billingPeriodName
      - text: Show billing period {billingPeriodName} balances for account {billingAccountId}.
        slots:
          billingPeriodName: path.billingPeriodName
          billingAccountId: path.billingAccountId
      method: generated
      generated: '2026-09-26'