# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Hugging Face Dataset Viewer Data Access API
  version: 1.0.0
extends: openapi/hugging-face-data-access-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: 2
- target: $.paths['/first-rows'].get
  update:
    x-apievangelist-phrasing:
      intent: Preview the first rows of a dataset split
      effect: read
      questions:
      - Can I peek at the first hundred rows of a dataset split to see what the data looks like?
      - What do the opening examples of a dataset's train split contain?
      instructions:
      - text: Show me the first rows of the {split} split in subset {config} of dataset {dataset}.
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
      - text: Preview the top of {dataset} ({config}, {split}) so I can see its columns.
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
      method: generated
      generated: '2026-10-01'
- target: $.paths['/rows'].get
  update:
    x-apievangelist-phrasing:
      intent: Page through rows of a dataset split
      effect: read
      questions:
      - Can I fetch rows from the middle of a dataset split by offset instead of only the beginning?
      - What is the most rows I can pull from a split in one request?
      instructions:
      - text: Get {length} rows starting at row {offset} from the {split} split of {dataset} subset {config}.
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
          offset: query.offset
          length: query.length
      - text: Fetch the next page of rows from {dataset} {config} {split} beginning at offset {offset}.
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
          offset: query.offset
      method: generated
      generated: '2026-10-01'