# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Analytics 2.0 Data Feed API. Create, update retrieve, and manage data feeds and column presets. Datafeed API
  version: 1.0.0
extends: openapi/adobe-analytics-datafeed-api-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: 8
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a raw data feed
      effect: write
      questions:
      - How do I set up a recurring raw clickstream data feed for a report suite?
      - What fields are required when creating a data feed?
      instructions:
      - text: Create data feed {feedName} on report suite {rsid} in company {globalCompanyId} with column preset {columnPreset}.
        slots:
          globalCompanyId: path.globalCompanyId
          feedName: requestBody.feedName
          rsid: requestBody.rsid
          columnPreset: requestBody.columnPreset
      - text: Set up data feed {feedName} for {rsid} on schedule {schedule}, delivered to {delivery}, using preset {columnPreset}.
        slots:
          feedName: requestBody.feedName
          rsid: requestBody.rsid
          schedule: requestBody.schedule
          delivery: requestBody.delivery
          columnPreset: requestBody.columnPreset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed/{feedId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data feed
      effect: read
      questions:
      - How do I see the configuration of one data feed?
      - What schedule and delivery is a given data feed using?
      instructions:
      - text: Get data feed {feedId} in company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
          feedId: path.feedId
      - text: Show the settings of data feed {feedId}.
        slots:
          feedId: path.feedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed/{feedId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a data feed's settings
      effect: write
      questions:
      - Can I change the column preset or delivery of an existing data feed?
      - Which data feed fields am I allowed to update after creation?
      instructions:
      - text: Switch data feed {feedId} in company {globalCompanyId} to column preset {columnPreset}.
        slots:
          globalCompanyId: path.globalCompanyId
          feedId: path.feedId
          columnPreset: requestBody.columnPreset
      - text: Update the delivery of data feed {feedId} to {delivery}.
        slots:
          feedId: path.feedId
          delivery: requestBody.delivery
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed/{feedId}/status'].put
  update:
    x-apievangelist-phrasing:
      intent: Pause, resume or change a data feed's status
      effect: write
      questions:
      - How do I pause or reactivate a data feed?
      - Can I change a data feed's status without editing the rest of it?
      instructions:
      - text: Set the status of data feed {feedId} in company {globalCompanyId} to {status}.
        slots:
          globalCompanyId: path.globalCompanyId
          feedId: path.feedId
          status: query.status
      - text: Change data feed {feedId} status to {status}.
        slots:
          feedId: path.feedId
          status: query.status
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List data feeds for one report suite
      effect: read
      questions:
      - What data feeds are configured for a single report suite?
      - How do I see every data feed on one RSID?
      instructions:
      - text: List data feeds for report suite {rsid} in company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
          rsid: query.rsid
      - text: Show all data feeds on {rsid}.
        slots:
          rsid: query.rsid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeeds/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search data feeds across several report suites
      effect: read
      questions:
      - Can I get the data feeds for many report suites in one call?
      - How do I list data feeds across a set of RSIDs?
      instructions:
      - text: Search data feeds in company {globalCompanyId} for report suites {rsids}.
        slots:
          globalCompanyId: path.globalCompanyId
          rsids: requestBody.rsids
      - text: Get the data feeds belonging to any of {rsids}.
        slots:
          rsids: requestBody.rsids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: List delivery requests for one data feed
      effect: read
      questions:
      - How do I see the recent delivery runs of one data feed?
      - Can I get a data feed's requests between two dates?
      instructions:
      - text: List requests for data feed {feedId} on report suite {rsid} in company {globalCompanyId}.
        slots:
          globalCompanyId: path.globalCompanyId
          feedId: query.feedId
          rsid: query.rsid
      - text: Show requests for feed {feedId} on {rsid} from {startDate} to {endDate}.
        slots:
          feedId: query.feedId
          rsid: query.rsid
          startDate: query.startDate
          endDate: query.endDate
      method: generated
      generated: '2026-10-01'
- target: $.paths['/{globalCompanyId}/data_feeds/datafeed/requests/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search data feed requests by criteria
      effect: read
      questions:
      - Which data feed requests failed across my report suites?
      - Can I search data feed requests by state, feed and completion date?
      instructions:
      - text: Search data feed requests in company {globalCompanyId} for report suites {rsids}.
        slots:
          globalCompanyId: path.globalCompanyId
          rsids: requestBody.rsids
      - text: Find data feed requests on {rsids} in state {requestStates}.
        slots:
          rsids: requestBody.rsids
          requestStates: requestBody.requestStates
      method: generated
      generated: '2026-10-01'