# 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 Resource Explorer API
  version: 1.0.0
extends: openapi/palo-alto-networks-resource-explorer-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['/resource'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a cloud resource's details
      effect: read
      questions:
      - How do I look up the full details of a cloud resource by its RRN?
      - Can I fetch details for several resources at once with a list of RRNs?
      instructions:
      - text: Get details for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Get resource details for RRNs {rrnList}.
        slots:
          rrnList: requestBody.rrnList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/alert'].post
  update:
    x-apievangelist-phrasing:
      intent: List alerts on a cloud resource
      effect: read
      questions:
      - Which alerts are open against a specific cloud resource?
      - What security alerts has this resource triggered?
      instructions:
      - text: List alerts for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Show every alert associated with resource {rrn}.
        slots:
          rrn: requestBody.rrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/network'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a resource's network port settings
      effect: read
      questions:
      - Which network ports are open on a given cloud resource?
      - How is a resource's network configured according to Resource Explorer?
      instructions:
      - text: Get the network port settings for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Show the network configuration of {rrn}.
        slots:
          rrn: requestBody.rrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/external_finding'].get
  update:
    x-apievangelist-phrasing:
      intent: List host findings for an alert
      effect: read
      questions:
      - What host findings are attached to a specific alert?
      - Can I narrow an alert's host findings to one finding type or source?
      instructions:
      - text: List host findings for alert {alertId}.
        slots:
          alertId: query.alertId
      - text: Show {type} host findings from source {source} for alert {alertId}.
        slots:
          type: query.type
          source: query.source
          alertId: query.alertId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/external_finding'].post
  update:
    x-apievangelist-phrasing:
      intent: List host findings for a resource
      effect: read
      questions:
      - Which host findings, like GuardDuty or vulnerability results, exist for a resource?
      - Can I filter a resource's host findings by finding type and skip low severities?
      instructions:
      - text: List host findings for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Show {findingType} host findings for resource {rrn}, excluding severities {excludeSeverityList}.
        slots:
          findingType: requestBody.findingType
          rrn: requestBody.rrn
          excludeSeverityList: requestBody.excludeSeverityList
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/timeline'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a resource's event and alert timeline
      effect: read
      questions:
      - What has happened to a cloud resource over time, event by event?
      - Can I see the change and alert history of a resource in order?
      instructions:
      - text: Get the timeline for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Show the chronological events and alerts on {rrn}.
        slots:
          rrn: requestBody.rrn
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/raw'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a resource's raw config at a point in time
      effect: read
      questions:
      - How do I see the raw cloud provider JSON for a resource as it was at a past point in time?
      - Can I pull a resource's raw configuration for a specific timeline entry?
      instructions:
      - text: Get the raw configuration of resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Get raw metadata for {rrn} at timeline item {timelineItemId}.
        slots:
          rrn: requestBody.rrn
          timelineItemId: requestBody.timelineItemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/resource/external_integration'].post
  update:
    x-apievangelist-phrasing:
      intent: List external ingest integrations for a resource
      effect: read
      questions:
      - Which external ingestion integrations are feeding data about this resource?
      - Does a resource have any third-party ingest integrations linked to it?
      instructions:
      - text: List external ingest integrations for resource {rrn}.
        slots:
          rrn: requestBody.rrn
      - text: Show which external integrations ingest data for {rrn}.
        slots:
          rrn: requestBody.rrn
      method: generated
      generated: '2026-09-26'