# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Adoption Advisor API
  version: 1.0.0
extends: openapi/palo-alto-networks-adoption-advisor-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: 8
- target: $.paths['/adoptionadvisor/checks'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the adoption check score
      effect: read
      questions:
      - Which Prisma Cloud capabilities have we adopted and which are still unused?
      - Can I see the formula behind my adoption score?
      instructions:
      - text: Show my adoption check score.
      - text: Get the adoption score with showFormula set to {showFormula}.
        slots:
          showFormula: query.showFormula
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report'].get
  update:
    x-apievangelist-phrasing:
      intent: List Adoption Advisor report configs
      effect: read
      questions:
      - What scheduled Adoption Advisor reports are configured?
      - Who receives our Adoption Advisor report emails?
      instructions:
      - text: List all Adoption Advisor report configurations.
      - text: Show the scheduled Adoption Advisor reports and their recipients.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report'].post
  update:
    x-apievangelist-phrasing:
      intent: Schedule an Adoption Advisor report
      effect: write
      questions:
      - How do I schedule a recurring Adoption Advisor report by email?
      - Can I choose how many days of data a scheduled adoption report covers?
      instructions:
      - text: Schedule Adoption Advisor report {name} on {schedule} to {emailIds} covering {widgetDays} days, enabled {enabled}.
        slots:
          name: requestBody.name
          schedule: requestBody.schedule
          emailIds: requestBody.emailIds
          widgetDays: requestBody.widgetDays
          enabled: requestBody.enabled
      - text: Save a report config {name} emailing {emailIds} with schedule {schedule}, {widgetDays} days, enabled {enabled}.
        slots:
          name: requestBody.name
          emailIds: requestBody.emailIds
          schedule: requestBody.schedule
          widgetDays: requestBody.widgetDays
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate an Adoption Advisor report now
      effect: write
      questions:
      - Can I generate an Adoption Advisor report immediately instead of waiting for the schedule?
      - How do I get an on-demand adoption report sent to a set of emails?
      instructions:
      - text: Generate Adoption Advisor report {name} now for {emailIds} over {widgetDays} days (schedule {schedule}, enabled {enabled}).
        slots:
          name: requestBody.name
          emailIds: requestBody.emailIds
          widgetDays: requestBody.widgetDays
          schedule: requestBody.schedule
          enabled: requestBody.enabled
      - text: Run an on-demand adoption report {name} to {emailIds}, {widgetDays} days, schedule {schedule}, enabled {enabled}.
        slots:
          name: requestBody.name
          emailIds: requestBody.emailIds
          widgetDays: requestBody.widgetDays
          schedule: requestBody.schedule
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report/{reportId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an Adoption Advisor report
      effect: write
      questions:
      - Can I change the recipients or schedule of an existing Adoption Advisor report?
      - How do I pause a scheduled adoption report?
      instructions:
      - text: 'Update report {reportId}: name {name}, recipients {emailIds}, schedule {schedule}, {widgetDays} days, enabled {enabled}.'
        slots:
          reportId: path.reportId
          name: requestBody.name
          emailIds: requestBody.emailIds
          schedule: requestBody.schedule
          widgetDays: requestBody.widgetDays
          enabled: requestBody.enabled
      - text: Change Adoption Advisor report {reportId} ({name}) schedule to {schedule} for {emailIds}, {widgetDays} days, enabled {enabled}.
        slots:
          reportId: path.reportId
          name: requestBody.name
          schedule: requestBody.schedule
          emailIds: requestBody.emailIds
          widgetDays: requestBody.widgetDays
          enabled: requestBody.enabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report/{reportId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Adoption Advisor report
      effect: destructive
      questions:
      - How do I stop and remove an Adoption Advisor report configuration?
      - Is deleting an Adoption Advisor report irreversible?
      instructions:
      - text: Delete Adoption Advisor report {reportId}.
        slots:
          reportId: path.reportId
      - text: Remove report config {reportId}.
        slots:
          reportId: path.reportId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report/{reportId}/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download the latest Adoption Advisor report
      effect: read
      questions:
      - Where can I download the most recent run of an Adoption Advisor report?
      - Can I grab the newest adoption report file without knowing when it ran?
      instructions:
      - text: Download the latest run of Adoption Advisor report {reportId}.
        slots:
          reportId: path.reportId
      - text: Get the newest file for report {reportId}.
        slots:
          reportId: path.reportId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/adoptionadvisor/report/{reportId}/{createdOn}/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a past Adoption Advisor report run
      effect: read
      questions:
      - Can I download an older Adoption Advisor report from a specific date?
      - How do I retrieve a historical adoption report by its creation time?
      instructions:
      - text: Download report {reportId} created on {createdOn}.
        slots:
          reportId: path.reportId
          createdOn: path.createdOn
      - text: Fetch the Adoption Advisor report {reportId} run from {createdOn}.
        slots:
          reportId: path.reportId
          createdOn: path.createdOn
      method: generated
      generated: '2026-09-26'