# 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 Tool for Microsoft 365 App Compliance…
  version: 1.0.0
extends: openapi/microsoft-azure-appcomplianceautomation-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: 9
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Compliance Automation API operations
      effect: read
      questions:
      - Which REST operations does the App Compliance Automation provider expose?
      - What actions can I perform through App Compliance Automation?
      instructions:
      - text: List the available App Compliance Automation operations.
      - text: Show every REST action the compliance automation provider supports.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports'].get
  update:
    x-apievangelist-phrasing:
      intent: List compliance reports for the tenant
      effect: read
      questions:
      - Which App Compliance Automation reports exist in my tenant?
      - Can I filter compliance reports by offer GUID or creator tenant?
      instructions:
      - text: List compliance automation reports in my tenant.
      - text: Show the first {top} compliance reports for offer {offer}.
        slots:
          top: query.$top
          offer: query.offerGuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a compliance report
      effect: read
      questions:
      - What are the properties of one App Compliance Automation report?
      - Can I open a compliance report by name?
      instructions:
      - text: Get compliance report {report}.
        slots:
          report: path.reportName
      - text: Show the details and properties of report {report}.
        slots:
          report: path.reportName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a compliance report
      effect: write
      questions:
      - How do I create a new App Compliance Automation report?
      - Can I overwrite an existing compliance report with new properties?
      instructions:
      - text: Create compliance report {report} with properties {props}.
        slots:
          report: path.reportName
          props: requestBody.properties
      - text: Create or fully replace report {report} using {props}.
        slots:
          report: path.reportName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a compliance report
      effect: destructive
      questions:
      - Can I delete an App Compliance Automation report?
      - What is lost when a compliance report is removed?
      instructions:
      - text: Delete compliance report {report}.
        slots:
          report: path.reportName
      - text: Remove the App Compliance Automation report named {report}.
        slots:
          report: path.reportName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing compliance report
      effect: write
      questions:
      - Can I change a few settings on a compliance report without replacing it?
      - Which compliance report properties can be patched?
      instructions:
      - text: Patch compliance report {report} with {props}.
        slots:
          report: path.reportName
          props: requestBody.properties
      - text: Partially update existing report {report}, changing only {props}.
        slots:
          report: path.reportName
          props: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List snapshots of a compliance report
      effect: read
      questions:
      - What snapshots have been taken of my compliance report?
      - Can I page through a report's snapshot history?
      instructions:
      - text: List snapshots of compliance report {report}.
        slots:
          report: path.reportName
      - text: Show the latest {top} snapshots for report {report}.
        slots:
          top: query.$top
          report: path.reportName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}/snapshots/{snapshotName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a compliance report snapshot
      effect: read
      questions:
      - What does one snapshot of a compliance report contain?
      - Can I fetch a specific report snapshot by name?
      instructions:
      - text: Get snapshot {snapshot} of compliance report {report}.
        slots:
          snapshot: path.snapshotName
          report: path.reportName
      - text: Show the properties of report snapshot {snapshot}.
        slots:
          snapshot: path.snapshotName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppComplianceAutomation/reports/{reportName}/snapshots/{snapshotName}/download'].post
  update:
    x-apievangelist-phrasing:
      intent: Download a compliance report or resource list
      effect: read
      questions:
      - How do I download the compliance report from a snapshot?
      - Can I export a snapshot's resource list instead of the full report?
      instructions:
      - text: Download {kind} from snapshot {snapshot} of report {report}.
        slots:
          kind: requestBody.downloadType
          snapshot: path.snapshotName
          report: path.reportName
      - text: Export the resource list from snapshot {snapshot} of report {report} as download type {kind}.
        slots:
          snapshot: path.snapshotName
          report: path.reportName
          kind: requestBody.downloadType
      method: generated
      generated: '2026-09-26'