# 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 Files & Metadata API
  version: 1.0.0
extends: openapi/hugging-face-files-metadata-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['/parquet'].get
  update:
    x-apievangelist-phrasing:
      intent: List Parquet files via the Dataset Viewer
      effect: read
      questions:
      - Can the Dataset Viewer tell me which Parquet files a dataset was converted into, per subset and split?
      - Where can I download a dataset as Parquet for efficient querying?
      instructions:
      - text: List the Parquet files the Dataset Viewer has for {dataset}.
        slots:
          dataset: query.dataset
      - text: Get Parquet download URLs per split for dataset {dataset}.
        slots:
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/size'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset's row count and byte size
      effect: read
      questions:
      - How many rows and bytes does a dataset have in total and per split?
      - Can I check how big a dataset is before downloading it?
      instructions:
      - text: Get the size of dataset {dataset}.
        slots:
          dataset: query.dataset
      - text: Tell me the number of rows and bytes in each split of {dataset}.
        slots:
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'
- target: $.paths['/statistics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get column statistics for a dataset split
      effect: read
      questions:
      - Can I see distributions, means and null counts for the columns of a dataset split?
      - What summary statistics are computed for each column in a split?
      instructions:
      - text: Get column statistics for the {split} split of {dataset} subset {config}.
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
      - text: Show the value distributions for {dataset} ({config}, {split}).
        slots:
          dataset: query.dataset
          config: query.config
          split: query.split
      method: generated
      generated: '2026-10-01'
- target: $.paths['/croissant'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset's Croissant metadata
      effect: read
      questions:
      - Can I get schema.org-compatible Croissant metadata describing an ML dataset?
      - Which endpoint returns a dataset's description in the Croissant format?
      instructions:
      - text: Get the Croissant metadata for dataset {dataset}.
        slots:
          dataset: query.dataset
      - text: Export {dataset} as a Croissant JSON-LD description.
        slots:
          dataset: query.dataset
      method: generated
      generated: '2026-10-01'