# 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 Applications API
  version: 1.0.0
extends: openapi/power-platform-applications-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: 4
- target: $.paths['/appmanagement/environments/{environmentId}/applicationPackages'].get
  update:
    x-apievangelist-phrasing:
      intent: List application packages for an environment
      effect: read
      questions:
      - Which app packages can I install in a particular Power Platform environment?
      - Can I see which packages are already installed in an environment and at what version?
      instructions:
      - text: List the application packages available in environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Show install status and versions of packages in environment {environmentId}.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/appmanagement/environments/{environmentId}/applicationPackages/{applicationPackageId}/install'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an application package in an environment
      effect: write
      questions:
      - How do I install a Microsoft app package into one of my environments?
      - What do I get back when I kick off a package install?
      instructions:
      - text: Install package {applicationPackageId} in environment {environmentId}.
        slots:
          applicationPackageId: path.applicationPackageId
          environmentId: path.environmentId
      - text: Deploy application package {applicationPackageId} to {environmentId} and return the operation ID.
        slots:
          applicationPackageId: path.applicationPackageId
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/appmanagement/environments/{environmentId}/operations/{operationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an application package install's status
      effect: read
      questions:
      - Has my application package install finished or failed?
      - How do I poll the progress of a package installation I already started?
      instructions:
      - text: Check the status of install operation {operationId} in environment {environmentId}.
        slots:
          operationId: path.operationId
          environmentId: path.environmentId
      - text: Poll package install {operationId} on {environmentId} until it completes.
        slots:
          operationId: path.operationId
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/appmanagement/applicationPackages'].get
  update:
    x-apievangelist-phrasing:
      intent: List installable packages for the tenant
      effect: read
      questions:
      - What Microsoft-provided application packages are available to my whole tenant?
      - Which app packages could I deploy to any environment in the tenant?
      instructions:
      - text: List the tenant-wide installable application packages.
      - text: Show tenant application packages using API version {api_version}.
        slots:
          api_version: query.api-version
      method: generated
      generated: '2026-09-26'