# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Helios Reporting service Components API
  version: 1.0.0
extends: openapi/cohesity-components-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: 4
- target: $.paths['/public/components'].get
  update:
    x-apievangelist-phrasing:
      intent: List report components
      effect: read
      questions:
      - Which report components can I access?
      - Can I fetch only certain report components by id?
      instructions:
      - text: List all report components I can access.
      - text: Show report components {ids}.
        slots:
          ids: query.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/components/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one report component
      effect: read
      questions:
      - What does a particular report component contain?
      - How is a specific report component defined?
      instructions:
      - text: Show report component {id}.
        slots:
          id: path.id
      - text: Get the definition of component {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/components/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview several report components
      effect: read
      questions:
      - Can I preview the data for several report components before building a report?
      - How do I preview components with filters in my time zone?
      instructions:
      - text: Preview components {components}.
        slots:
          components: requestBody.components
      - text: Preview components {components} with filters {filters} in time zone {timezone}.
        slots:
          components: requestBody.components
          filters: requestBody.filters
          timezone: requestBody.timezone
      method: generated
      generated: '2026-10-01'
- target: $.paths['/public/components/{id}/preview'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a single report component
      effect: read
      questions:
      - What data would one report component show right now?
      - Can I sort and limit the rows when previewing a single component?
      instructions:
      - text: Preview report component {id}.
        slots:
          id: path.id
      - text: Preview component {id} sorted by {sort}, limited to {limit} rows.
        slots:
          id: path.id
          sort: requestBody.sort
          limit: requestBody.limit
      method: generated
      generated: '2026-10-01'