Palo Alto Networks · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Prisma Cloud Access Keys API Overview Resource Lists API

7 actions 7 updates phrasing extends openapi/palo-alto-networks-resource-lists-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 7

$.info

$.paths['/v1/resource_list'].get

$.paths['/v1/resource_list'].post

$.paths['/v1/resource_list/types'].get

$.paths['/v1/resource_list/{id}'].get

$.paths['/v1/resource_list/{id}'].put

$.paths['/v1/resource_list/{id}'].delete

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 Prisma Cloud Access Keys API Overview Resource Lists API
  version: 1.0.0
extends: openapi/palo-alto-networks-resource-lists-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: 6
- target: $.paths['/v1/resource_list'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource lists of a type
      effect: read
      questions:
      - What resource lists do I have of a given type?
      - Can I see all my tag or account group resource lists?
      instructions:
      - text: List my resource lists of type {listType}.
        slots:
          listType: query.listType
      - text: Show all {listType} resource lists.
        slots:
          listType: query.listType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/resource_list'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a resource list
      effect: write
      questions:
      - How do I create a new resource list with members?
      - What do I need to specify when adding a resource list?
      instructions:
      - text: Create a {resourceListType} resource list named {name} with members {members}.
        slots:
          resourceListType: requestBody.resourceListType
          name: requestBody.name
          members: requestBody.members
      - text: Add resource list {name} of type {resourceListType} containing {members}.
        slots:
          name: requestBody.name
          resourceListType: requestBody.resourceListType
          members: requestBody.members
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/resource_list/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List resource list types
      effect: read
      questions:
      - Which kinds of resource lists are supported?
      - What resource list types can I choose from?
      instructions:
      - text: List the available resource list types.
      - text: Show every supported resource list type.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/resource_list/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource list
      effect: read
      questions:
      - How can I see the members of one resource list?
      - Can I fetch a single resource list by its ID?
      instructions:
      - text: Get resource list {id}.
        slots:
          id: path.id
      - text: Show the members of resource list {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/resource_list/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a resource list
      effect: write
      questions:
      - Can I change the members of an existing resource list?
      - Is renaming a resource list supported?
      instructions:
      - text: Replace the members of resource list {id} with {members}, keeping name {name} and type {resourceListType}.
        slots:
          id: path.id
          members: requestBody.members
          name: requestBody.name
          resourceListType: requestBody.resourceListType
      - text: Rename resource list {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/resource_list/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource list
      effect: destructive
      questions:
      - How do I remove a resource list I no longer need?
      - Can a resource list be deleted by ID?
      instructions:
      - text: Delete resource list {id}.
        slots:
          id: path.id
      - text: Remove the resource list with ID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'