# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Power Platform REST Licensing API
  version: 1.0.0
extends: openapi/power-platform-licensing-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: 5
- target: $.paths['/licensing/billingPolicies'].get
  update:
    x-apievangelist-phrasing:
      intent: List the tenant's billing policies
      effect: read
      questions:
      - Which pay-as-you-go billing policies are configured for my tenant?
      - Can I cap how many billing policies come back in one call?
      - What billing policies link my environments to Azure subscriptions?
      instructions:
      - text: List all billing policies configured for my tenant.
      - text: Show the first {top} billing policies.
        slots:
          top: query.$top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/licensing/billingPolicies'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pay-as-you-go billing policy
      effect: write
      questions:
      - How do I set up pay-as-you-go billing for Power Platform against an Azure subscription?
      - What do I need to provide to create a new billing policy?
      instructions:
      - text: Create billing policy {name} in {location} billed to {billingInstrument}.
        slots:
          name: requestBody.name
          location: requestBody.location
          billingInstrument: requestBody.billingInstrument
      - text: Create a new billing policy {name} in {location} with status {status} using {billingInstrument}.
        slots:
          name: requestBody.name
          location: requestBody.location
          status: requestBody.status
          billingInstrument: requestBody.billingInstrument
      method: generated
      generated: '2026-09-26'
- target: $.paths['/licensing/billingPolicies/{billingPolicyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a billing policy
      effect: read
      questions:
      - What are the details of one specific billing policy?
      - Which Azure subscription is a given billing policy tied to?
      instructions:
      - text: Get billing policy {billingPolicyId}.
        slots:
          billingPolicyId: path.billingPolicyId
      - text: Show the billing instrument and status of policy {billingPolicyId}.
        slots:
          billingPolicyId: path.billingPolicyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/licensing/billingPolicies/{billingPolicyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a billing policy
      effect: destructive
      questions:
      - How do I remove a pay-as-you-go billing policy?
      - Can I delete a billing policy by its ID?
      instructions:
      - text: Delete billing policy {billingPolicyId}.
        slots:
          billingPolicyId: path.billingPolicyId
      - text: Remove the billing policy with ID {billingPolicyId}.
        slots:
          billingPolicyId: path.billingPolicyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/licensing/billingPolicies/{billingPolicyId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing billing policy
      effect: write
      questions:
      - Can I rename an existing billing policy?
      - How do I change the status or Azure subscription on a billing policy I already have?
      instructions:
      - text: Rename billing policy {billingPolicyId} to {name}.
        slots:
          billingPolicyId: path.billingPolicyId
          name: requestBody.name
      - text: Set the status of billing policy {billingPolicyId} to {status}.
        slots:
          billingPolicyId: path.billingPolicyId
          status: requestBody.status
      - text: Point existing billing policy {billingPolicyId} at billing instrument {billingInstrument}.
        slots:
          billingPolicyId: path.billingPolicyId
          billingInstrument: requestBody.billingInstrument
      method: generated
      generated: '2026-09-26'