# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for RIC Feed API
  version: 1.0.0
extends: openapi/clarivate-feed-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['/ric/download/v1/requestPackage'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a content package for download
      effect: write
      questions:
      - How do I start preparing a bulk download package of a content set?
      - Can I split the prepared package into multiple files or choose its format?
      - Which preset do I need when requesting a content feed package?
      instructions:
      - text: Request a download package of content set {contentSet} using preset {preset}.
        slots:
          contentSet: requestBody.contentSet
          preset: requestBody.preset
      - text: Prepare a {format} package of {contentSet} with preset {preset}.
        slots:
          contentSet: requestBody.contentSet
          preset: requestBody.preset
          format: requestBody.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ric/download/v1/checkPackageStatus'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a download package's status
      effect: read
      questions:
      - How do I know when my requested content package is ready?
      - Is my feed package still being prepared?
      instructions:
      - text: Check the status of package {token}.
        slots:
          token: query.token
      - text: Tell me whether download package {token} has finished preparing.
        slots:
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ric/download/v1/downloadPackage'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a prepared content package
      effect: read
      questions:
      - How do I download the result file once my content package is ready?
      - Can I fetch a finished feed package using its token?
      instructions:
      - text: Download package {token}.
        slots:
          token: query.token
      - text: Fetch the finished result file for feed token {token}.
        slots:
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ric/download/v1/info'].get
  update:
    x-apievangelist-phrasing:
      intent: List my content subscriptions
      effect: read
      questions:
      - Which content sets am I subscribed to in the feed API?
      - What content subscriptions does my account have for bulk downloads?
      instructions:
      - text: Show my content subscriptions.
      - text: List the content sets my account can download.
      method: generated
      generated: '2026-09-26'