# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Objects External Dynamic Lists API
  version: 1.0.0
extends: openapi/palo-alto-networks-external-dynamic-lists-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['/external-dynamic-lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List external dynamic lists
      effect: read
      questions:
      - Which external dynamic lists feed my firewall policies?
      - Can I list EDLs for one folder or device?
      instructions:
      - text: List external dynamic lists in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the external dynamic list named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/external-dynamic-lists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an external dynamic list
      effect: write
      questions:
      - How do I add a new external dynamic list of IPs or URLs?
      - What EDL types can I create?
      instructions:
      - text: Create an external dynamic list named {name} of type {type}.
        slots:
          name: requestBody.name
          type: requestBody.type
      - text: Add a new EDL called {name}.
        slots:
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/external-dynamic-lists/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an external dynamic list
      effect: read
      questions:
      - What source and type does a specific external dynamic list use?
      - Can I retrieve one EDL by ID?
      instructions:
      - text: Get external dynamic list {id}.
        slots:
          id: path.id
      - text: Show the type and source of EDL {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/external-dynamic-lists/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an external dynamic list
      effect: write
      questions:
      - Can I change the type or source of an existing external dynamic list?
      - How do I rename an EDL?
      instructions:
      - text: Update external dynamic list {id} named {name} to type {type}.
        slots:
          id: path.id
          name: requestBody.name
          type: requestBody.type
      - text: Rename EDL {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/external-dynamic-lists/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an external dynamic list
      effect: destructive
      questions:
      - Can I remove an external dynamic list that no rule uses?
      - What's needed to delete an EDL?
      instructions:
      - text: Delete external dynamic list {id}.
        slots:
          id: path.id
      - text: Remove EDL {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/sse/config/v1/external-dynamic-lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List external dynamic lists
      effect: read
      questions:
      - Which external dynamic lists are configured in a Prisma Access folder?
      - Can I find an external dynamic list by name?
      instructions:
      - text: List the SSE config external dynamic lists in folder {folder}.
        slots:
          folder: query.folder
      - text: Find the EDL named {name} in folder {folder}.
        slots:
          name: query.name
          folder: query.folder
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/external-dynamic-lists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an external dynamic list
      effect: write
      questions:
      - How do I add an external dynamic list of IPs or domains for use in security policy?
      - Which EDL types can I create?
      instructions:
      - text: Create external dynamic list {name} of type {type} in folder {folder}.
        slots:
          name: requestBody.name
          type: requestBody.type
          folder: query.folder
      - text: Add a new {type} EDL called {name} to folder {folder}.
        slots:
          type: requestBody.type
          name: requestBody.name
          folder: query.folder
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/external-dynamic-lists/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an external dynamic list
      effect: read
      questions:
      - What type and source does a specific external dynamic list have?
      - Can I fetch one EDL by its ID?
      instructions:
      - text: Fetch SSE config external dynamic list {id}.
        slots:
          id: path.id
      - text: Show the configuration of EDL {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/external-dynamic-lists/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an external dynamic list
      effect: write
      questions:
      - Can I edit an EDL in place through the SSE config v1 endpoint?
      - Is it possible to modify an EDL in place?
      instructions:
      - text: Edit external dynamic list {id} to name {name} and type {type}.
        slots:
          id: path.id
          name: requestBody.name
          type: requestBody.type
      - text: Rename EDL {id} to {name}, keeping type {type}.
        slots:
          id: path.id
          name: requestBody.name
          type: requestBody.type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sse/config/v1/external-dynamic-lists/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an external dynamic list
      effect: destructive
      questions:
      - Can I delete an external dynamic list that policy no longer references?
      - What happens when an EDL is removed?
      instructions:
      - text: Delete SSE config external dynamic list {id}.
        slots:
          id: path.id
      - text: Remove EDL {id} using the SSE v1 API.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'