Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Prisma Browser Management Console Public Configuration…

11 actions 11 updates phrasing extends openapi/palo-alto-networks-configuration-management-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 11

$.info
$.paths['/seb-api/v1/configuration-management/draft/publish'].post
$.paths['/sse/config/v1/config-versions'].get
$.paths['/sse/config/v1/config-versions/candidate'].delete
$.paths['/sse/config/v1/config-versions/candidate:push'].post
$.paths['/sse/config/v1/config-versions/running'].get
$.paths['/sse/config/v1/config-versions/{version}'].get
$.paths['/sse/config/v1/config-versions:load'].post
$.paths['/sse/config/v1/jobs'].get
$.paths['/sse/config/v1/jobs/{id}'].get
$.paths['/sse/config/v1/snapshots'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Browser Management Console Public Configuration…
  version: 1.0.0
extends: openapi/palo-alto-networks-configuration-management-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/seb-api/v1/configuration-management/draft/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish the configuration draft
      effect: write
      questions:
      - How do I publish my pending configuration draft so it takes effect?
      - Can I add a description when I publish a draft configuration?
      instructions:
      - text: Publish the current configuration draft.
      - text: Publish the draft with description {description}.
        slots:
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/config-versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List candidate configuration versions
      effect: read
      questions:
      - What candidate configuration versions exist in Prisma Access?
      - Can I page through the configuration version history?
      instructions:
      - text: List my Prisma Access configuration versions.
      - text: Show {limit} configuration versions starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/config-versions/candidate'].delete
  update:
    x-apievangelist-phrasing:
      intent: Discard candidate changes and revert to running
      effect: destructive
      questions:
      - How do I throw away uncommitted changes and go back to the running configuration?
      - Is rolling back the candidate configuration reversible?
      instructions:
      - text: Roll back the candidate configuration to the running configuration.
      - text: Discard all pending candidate config changes.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/config-versions/candidate:push'].post
  update:
    x-apievangelist-phrasing:
      intent: Push the candidate configuration to folders
      effect: write
      questions:
      - How do I push my pending Prisma Access candidate changes out to a folder?
      - Can I add a description when pushing the candidate configuration live?
      instructions:
      - text: Push the candidate configuration to folders {folders}.
        slots:
          folders: requestBody.folders
      - text: Push candidate changes to {folders} with the note {description}.
        slots:
          folders: requestBody.folders
          description: requestBody.description
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/config-versions/running'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the running configuration
      effect: read
      questions:
      - What configuration is currently running in each Prisma Access folder?
      - Which config version is live right now?
      instructions:
      - text: Show the running configuration across all folders.
      - text: Tell me which configuration version is live in each folder.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/config-versions/{version}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a configuration by version number
      effect: read
      questions:
      - How do I view a specific past configuration version?
      - Can I inspect what a numbered config version contained?
      instructions:
      - text: Get configuration version {version}.
        slots:
          version: path.version
      - text: Show me the contents of config version {version}.
        slots:
          version: path.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/config-versions:load'].post
  update:
    x-apievangelist-phrasing:
      intent: Load a configuration from a snapshot version
      effect: write
      questions:
      - How do I load an older snapshot as my candidate configuration?
      - Can I restore a Prisma Access config from a saved snapshot version?
      instructions:
      - text: Load configuration version {version} from a snapshot.
        slots:
          version: requestBody.version
      - text: Restore snapshot version {version} into the candidate config.
        slots:
          version: requestBody.version
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List configuration job history
      effect: read
      questions:
      - What configuration push and commit jobs have run recently?
      - Where can I see the history of Prisma Access config jobs?
      instructions:
      - text: List the Prisma Access configuration jobs history.
      - text: Show all recent configuration jobs and their results.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/jobs/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check one configuration job by its ID
      effect: read
      questions:
      - Did my configuration push job finish, and how can I check that single job?
      - What details can I see for one specific Prisma Access config job?
      instructions:
      - text: Show the status of configuration job {id}.
        slots:
          id: path.id
      - text: Look up config job {id} and tell me its result.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/snapshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List configuration snapshots
      effect: read
      questions:
      - What configuration snapshots are saved in Prisma Access?
      - Which snapshot versions could I load to restore a config?
      instructions:
      - text: List all Prisma Access configuration snapshots.
      - text: Show the saved config snapshots I can restore from.
      method: generated
      generated: '2026-10-01'