# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Manage Intelligent Feed API
  version: 1.0.0
extends: openapi/palo-alto-networks-intelligentfeed-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: 4
- target: $.paths['/v1/config/rulestacks/{rulestackname}/feeds'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an intelligence feed on a rulestack
      effect: write
      questions:
      - How do I add an external dynamic list as an intelligence feed on my Cloud NGFW rulestack?
      - Can I set how often a new threat intelligence feed is refreshed from its URL?
      instructions:
      - text: Create feed {Name} on rulestack {rulestackname} from {FeedURL}, type {Type}, refreshed {Frequency}.
        slots:
          Name: requestBody.Name
          rulestackname: path.rulestackname
          FeedURL: requestBody.FeedURL
          Type: requestBody.Type
          Frequency: requestBody.Frequency
      - text: Add intelligence feed {Name} of type {Type} to rulestack {rulestackname} pulling {FeedURL} every {Frequency} at {Time}.
        slots:
          Name: requestBody.Name
          Type: requestBody.Type
          rulestackname: path.rulestackname
          FeedURL: requestBody.FeedURL
          Frequency: requestBody.Frequency
          Time: requestBody.Time
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/config/rulestacks/{rulestackname}/feeds/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an intelligence feed's data
      effect: read
      questions:
      - What threat data has an intelligence feed collected for my rulestack?
      - Can I compare the candidate and running versions of a feed?
      instructions:
      - text: Show intelligence feed {name} on rulestack {rulestackname}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
      - text: Get the collected data for feed {name} in rulestack {rulestackname}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/config/rulestacks/{rulestackname}/feeds/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an intelligence feed
      effect: write
      questions:
      - Can I change the URL or refresh frequency of an existing intelligence feed?
      - How do I update the certificate used by a threat feed I already added?
      instructions:
      - text: Change existing feed {name} on rulestack {rulestackname} to pull {FeedURL} as type {Type} every {Frequency}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
          FeedURL: requestBody.FeedURL
          Type: requestBody.Type
          Frequency: requestBody.Frequency
      - text: Update feed {name} in rulestack {rulestackname} with certificate {Certificate}, keeping URL {FeedURL}, type {Type} and frequency {Frequency}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
          Certificate: requestBody.Certificate
          FeedURL: requestBody.FeedURL
          Type: requestBody.Type
          Frequency: requestBody.Frequency
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/config/rulestacks/{rulestackname}/feeds/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an intelligence feed
      effect: destructive
      questions:
      - How do I remove a threat intelligence feed from a rulestack?
      - Can I stop using an external dynamic list on my firewall rulestack?
      instructions:
      - text: Delete feed {name} from rulestack {rulestackname}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
      - text: Remove intelligence feed {name} from rulestack {rulestackname}.
        slots:
          name: path.name
          rulestackname: path.rulestackname
      method: generated
      generated: '2026-09-26'