# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Accounts and Settings External Feeds API
  version: 1.0.0
extends: openapi/brevo-external-feeds-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: 5
- target: $.paths['/feeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List external feeds
      effect: read
      questions:
      - Which external data feeds are powering dynamic content in my emails?
      - Can I search my external feeds by name?
      instructions:
      - text: List all my external feeds.
      - text: Search external feeds for {search}.
        slots:
          search: query.search
      - text: List external feeds that use auth type {authType}.
        slots:
          authType: query.authType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feeds'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an external feed
      effect: write
      questions:
      - How do I pull product data from my own URL into email campaigns?
      - Can an external feed use a bearer token or basic auth?
      instructions:
      - text: Create an external feed {name} pointing at {url}.
        slots:
          name: requestBody.name
          url: requestBody.url
      - text: Create feed {name} from {url} with auth type {authType} and token {token}.
        slots:
          name: requestBody.name
          url: requestBody.url
          authType: requestBody.authType
          token: requestBody.token
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feeds/{uuid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an external feed
      effect: read
      questions:
      - What URL and authentication does one of my feeds use?
      - Can I see a single external feed's full configuration?
      instructions:
      - text: Get external feed {uuid}.
        slots:
          uuid: path.uuid
      - text: Show the configuration of feed {uuid}.
        slots:
          uuid: path.uuid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feeds/{uuid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an external feed
      effect: write
      questions:
      - How do I point an existing feed at a new data URL?
      - Can I rotate the credentials on an external feed?
      instructions:
      - text: Change the URL of external feed {uuid} to {url}.
        slots:
          uuid: path.uuid
          url: requestBody.url
      - text: Set the token on feed {uuid} to {token}.
        slots:
          uuid: path.uuid
          token: requestBody.token
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feeds/{uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an external feed
      effect: destructive
      questions:
      - How do I remove a data feed I don't use anymore?
      - Can I delete an external feed?
      instructions:
      - text: Delete external feed {uuid}.
        slots:
          uuid: path.uuid
      - text: Remove the data feed {uuid}.
        slots:
          uuid: path.uuid
      method: generated
      generated: '2026-10-01'