# 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 Dataset Info API
  version: 1.0.0
extends: openapi/hugging-face-dataset-info-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['/is-valid'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if a dataset works in the Dataset Viewer
      effect: read
      questions:
      - Is a given dataset processed and available for preview, search and filtering in the Dataset Viewer?
      - Can I check whether statistics are available for a dataset before requesting them?
      instructions:
      - text: Check whether dataset {dataset} is valid in the Dataset Viewer.
        slots:
          dataset: query.dataset
      - text: Tell me which viewer features (preview, search, filter, statistics) work for {dataset}.
        slots:
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/splits'].get
  update:
    x-apievangelist-phrasing:
      intent: List a dataset's subsets and splits
      effect: read
      questions:
      - What subsets and train/test/validation splits does a dataset have?
      - Which configuration names do I need before I can read rows from a dataset?
      instructions:
      - text: List the subsets and splits of dataset {dataset}.
        slots:
          dataset: query.dataset
      - text: Show me which configs and splits {dataset} is divided into.
        slots:
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'