# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for PowerPlatform Accounts API
  version: 1.0.0
extends: openapi/power-platform-accounts-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.PowerPlatform/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Power Platform accounts in a subscription
      effect: read
      questions:
      - Which Power Platform accounts exist across my whole Azure subscription?
      - Can I see every Microsoft.PowerPlatform account in a subscription regardless of resource group?
      instructions:
      - text: List all Power Platform accounts in my Azure subscription.
      - text: Show every Power Platform account across the subscription, not just one resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/accounts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Power Platform accounts in a resource group
      effect: read
      questions:
      - What Power Platform accounts live in a single resource group?
      - How do I scope a Power Platform account listing to one resource group?
      instructions:
      - text: List the Power Platform accounts inside this resource group only.
      - text: Show me which Power Platform accounts were deployed to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/accounts/{accountName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Power Platform account
      effect: read
      questions:
      - What configuration does a specific Power Platform account have?
      - Where can I look up one account's location and tags by its name?
      instructions:
      - text: Get the details of Power Platform account {accountName}.
        slots:
          accountName: path.accountName
      - text: Show the properties and location of account {accountName}.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/accounts/{accountName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Power Platform account
      effect: write
      questions:
      - How do I create a new Power Platform account as an Azure resource?
      - Can I provision an account with its configuration properties in a single PUT?
      instructions:
      - text: Create a Power Platform account named {accountName}.
        slots:
          accountName: path.accountName
      - text: Provision account {accountName} with configuration {properties}.
        slots:
          accountName: path.accountName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/accounts/{accountName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Power Platform account
      effect: destructive
      questions:
      - How do I remove a Power Platform account I no longer need?
      - What happens when I delete an account resource from my resource group?
      instructions:
      - text: Delete Power Platform account {accountName}.
        slots:
          accountName: path.accountName
      - text: Remove the account {accountName} from Azure.
        slots:
          accountName: path.accountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PowerPlatform/accounts/{accountName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing Power Platform account
      effect: write
      questions:
      - Can I change the tags on an account that already exists?
      - How do I patch only some settings of an existing Power Platform account?
      instructions:
      - text: Update the tags on existing account {accountName} to {tags}.
        slots:
          accountName: path.accountName
          tags: requestBody.tags
      - text: Patch the properties of account {accountName} with {properties}.
        slots:
          accountName: path.accountName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'