Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Palo Alto Networks Audit Logs API

4 actions 4 updates phrasing extends openapi/palo-alto-networks-audit-logs-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Palo Alto Networks's API. It is a proposal applied on top of the contract, not a document Palo Alto Networks publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info

$.paths['/audit/api/v1/log'].post

$.paths['/audit/api/v1/filter/suggest'].post

$.paths['/audit/redlock'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Palo Alto Networks Audit Logs API
  version: 1.0.0
extends: openapi/palo-alto-networks-audit-logs-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: 3
- target: $.paths['/audit/api/v1/log'].post
  update:
    x-apievangelist-phrasing:
      intent: Search audit logs by time range and filters
      effect: read
      questions:
      - How do I pull audit logs for a specific time window with filters?
      - What's the rate limit when paging through the filtered audit log endpoint?
      instructions:
      - text: Get audit logs for time range {timeRange}.
        slots:
          timeRange: requestBody.timeRange
      - text: Fetch {limit} audit log entries in {timeRange} matching {filters}, from token {nextPageToken}.
        slots:
          limit: requestBody.limit
          timeRange: requestBody.timeRange
          filters: requestBody.filters
          nextPageToken: requestBody.nextPageToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/audit/api/v1/filter/suggest'].post
  update:
    x-apievangelist-phrasing:
      intent: Suggest audit log filter values
      effect: read
      questions:
      - What resource types or users can I filter audit logs by?
      - Can I get autocomplete suggestions for an audit log filter?
      instructions:
      - text: Suggest values for audit log filter {filterName}.
        slots:
          filterName: requestBody.filterName
      - text: Autocomplete {query} for audit filter {filterName}.
        slots:
          query: requestBody.query
          filterName: requestBody.filterName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/audit/redlock'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Prisma Cloud platform audit logs
      effect: read
      questions:
      - Who did what on the Prisma Cloud platform in the last few hours?
      - Can I get platform audit events for a relative time window like the past 7 days?
      instructions:
      - text: Show Prisma Cloud audit logs for the last {timeAmount} {timeUnit}.
        slots:
          timeAmount: query.timeAmount
          timeUnit: query.timeUnit
      - text: List platform audit events using time type {timeType}.
        slots:
          timeType: query.timeType
      method: generated
      generated: '2026-09-26'