naftiko: 1.0.0-alpha2
info:
  label: LangSmith — datasets
  description: 'LangSmith — datasets. 35 operations. Lead operation: Read Datasets. Self-contained Naftiko capability covering
    one Langsmith business surface.'
  tags:
  - Langsmith
  - datasets
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    LANGSMITH_API_KEY: LANGSMITH_API_KEY
capability:
  consumes:
  - type: http
    namespace: langsmith-datasets
    baseUri: ''
    description: LangSmith — datasets business capability. Self-contained, no shared references.
    resources:
    - name: api-v1-datasets
      path: /api/v1/datasets
      operations:
      - name: readdatasetsapiv1datasetsget
        method: GET
        description: Read Datasets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
        - name: data_type
          in: query
          type: string
        - name: name
          in: query
          type: string
        - name: name_contains
          in: query
          type: string
        - name: metadata
          in: query
          type: string
        - name: offset
          in: query
          type: integer
        - name: limit
          in: query
          type: integer
        - name: sort_by
          in: query
          type: string
        - name: sort_by_desc
          in: query
          type: boolean
        - name: tag_value_id
          in: query
          type: string
        - name: exclude_corrections_datasets
          in: query
          type: boolean
        - name: exclude
          in: query
          type: string
      - name: createdatasetapiv1datasetspost
        method: POST
        description: Create Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deletedatasetsapiv1datasetsdelete
        method: DELETE
        description: Delete Datasets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_ids
          in: query
          type: array
          required: true
    - name: api-v1-datasets-clone
      path: /api/v1/datasets/clone
      operations:
      - name: clonedatasetapiv1datasetsclonepost
        method: POST
        description: Clone Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-comparative
      path: /api/v1/datasets/comparative
      operations:
      - name: createcomparativeexperimentapiv1datasetscomparativepost
        method: POST
        description: Create Comparative Experiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-comparative-comparative_experiment_id
      path: /api/v1/datasets/comparative/{comparative_experiment_id}
      operations:
      - name: deletecomparativeexperimentapiv1datasetscomparativecomparativeexperimentiddelete
        method: DELETE
        description: Delete Comparative Experiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: comparative_experiment_id
          in: path
          type: string
          required: true
    - name: api-v1-datasets-playground_experiment-batch
      path: /api/v1/datasets/playground_experiment/batch
      operations:
      - name: datasethandlerapiv1datasetsplaygroundexperimentbatchpost
        method: POST
        description: Dataset Handler
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-playground_experiment-stream
      path: /api/v1/datasets/playground_experiment/stream
      operations:
      - name: streamdatasethandlerapiv1datasetsplaygroundexperimentstreampost
        method: POST
        description: Stream Dataset Handler
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-stream
      path: /api/v1/datasets/stream
      operations:
      - name: readdatasetsstreamapiv1datasetsstreamget
        method: GET
        description: Read Datasets Stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: query
          type: string
        - name: data_type
          in: query
          type: string
        - name: name
          in: query
          type: string
        - name: name_contains
          in: query
          type: string
        - name: metadata
          in: query
          type: string
        - name: offset
          in: query
          type: integer
        - name: limit
          in: query
          type: integer
        - name: sort_by
          in: query
          type: string
        - name: sort_by_desc
          in: query
          type: boolean
        - name: tag_value_id
          in: query
          type: string
        - name: exclude_corrections_datasets
          in: query
          type: boolean
    - name: api-v1-datasets-studio_experiment
      path: /api/v1/datasets/studio_experiment
      operations:
      - name: studioexperimentapiv1datasetsstudioexperimentpost
        method: POST
        description: Studio Experiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-upload
      path: /api/v1/datasets/upload
      operations:
      - name: uploadcsvdatasetapiv1datasetsuploadpost
        method: POST
        description: Upload Csv Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-upload-experiment
      path: /api/v1/datasets/upload-experiment
      operations:
      - name: uploadexperimentapiv1datasetsuploadexperimentpost
        method: POST
        description: Upload Experiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id
      path: /api/v1/datasets/{dataset_id}
      operations:
      - name: readdatasetapiv1datasetsdatasetidget
        method: GET
        description: Read Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
      - name: deletedatasetapiv1datasetsdatasetiddelete
        method: DELETE
        description: Delete Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
      - name: updatedatasetapiv1datasetsdatasetidpatch
        method: PATCH
        description: Update Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-comparative
      path: /api/v1/datasets/{dataset_id}/comparative
      operations:
      - name: readcomparativeexperimentsapiv1datasetsdatasetidcomparativeget
        method: GET
        description: Read Comparative Experiments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: name
          in: query
          type: string
        - name: name_contains
          in: query
          type: string
        - name: id
          in: query
          type: string
        - name: offset
          in: query
          type: integer
        - name: limit
          in: query
          type: integer
        - name: sort_by
          in: query
          type: string
        - name: sort_by_desc
          in: query
          type: boolean
    - name: api-v1-datasets-dataset_id-csv
      path: /api/v1/datasets/{dataset_id}/csv
      operations:
      - name: downloaddatasetcsvapiv1datasetsdatasetidcsvget
        method: GET
        description: Download Dataset Csv
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
          description: Only modifications made on or before this time are included. If None, the latest version of the dataset
            is used.
    - name: api-v1-datasets-dataset_id-experiments-grouped
      path: /api/v1/datasets/{dataset_id}/experiments/grouped
      operations:
      - name: readgroupedexperimentsapiv1datasetsdatasetidexperimentsgroupedpost
        method: POST
        description: Read Grouped Experiments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-generate
      path: /api/v1/datasets/{dataset_id}/generate
      operations:
      - name: generateapiv1datasetsdatasetidgeneratepost
        method: POST
        description: Generate
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-group-runs
      path: /api/v1/datasets/{dataset_id}/group/runs
      operations:
      - name: readexampleswithrunsgroupedapiv1datasetsdatasetidgrouprunspost
        method: POST
        description: Read Examples With Runs Grouped
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-jsonl
      path: /api/v1/datasets/{dataset_id}/jsonl
      operations:
      - name: downloaddatasetjsonlapiv1datasetsdatasetidjsonlget
        method: GET
        description: Download Dataset Jsonl
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
          description: Only modifications made on or before this time are included. If None, the latest version of the dataset
            is used.
    - name: api-v1-datasets-dataset_id-openai
      path: /api/v1/datasets/{dataset_id}/openai
      operations:
      - name: downloaddatasetopenaiapiv1datasetsdatasetidopenaiget
        method: GET
        description: Download Dataset Openai
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
          description: Only modifications made on or before this time are included. If None, the latest version of the dataset
            is used.
    - name: api-v1-datasets-dataset_id-openai_ft
      path: /api/v1/datasets/{dataset_id}/openai_ft
      operations:
      - name: downloaddatasetopenaiftapiv1datasetsdatasetidopenaiftget
        method: GET
        description: Download Dataset Openai Ft
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
          description: Only modifications made on or before this time are included. If None, the latest version of the dataset
            is used.
    - name: api-v1-datasets-dataset_id-runs
      path: /api/v1/datasets/{dataset_id}/runs
      operations:
      - name: readexampleswithrunsapiv1datasetsdatasetidrunspost
        method: POST
        description: Read Examples With Runs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: format
          in: query
          type: string
          description: Response format, e.g., 'csv'
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-runs-delta
      path: /api/v1/datasets/{dataset_id}/runs/delta
      operations:
      - name: readdeltaapiv1datasetsdatasetidrunsdeltapost
        method: POST
        description: Read Delta
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-runs-delta-stream
      path: /api/v1/datasets/{dataset_id}/runs/delta/stream
      operations:
      - name: readdeltastreamapiv1datasetsdatasetidrunsdeltastreampost
        method: POST
        description: Read Delta Stream
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-share
      path: /api/v1/datasets/{dataset_id}/share
      operations:
      - name: readdatasetsharestateapiv1datasetsdatasetidshareget
        method: GET
        description: Read Dataset Share State
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
      - name: sharedatasetapiv1datasetsdatasetidshareput
        method: PUT
        description: Share Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: share_projects
          in: query
          type: boolean
      - name: unsharedatasetapiv1datasetsdatasetidsharedelete
        method: DELETE
        description: Unshare Dataset
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
    - name: api-v1-datasets-dataset_id-splits
      path: /api/v1/datasets/{dataset_id}/splits
      operations:
      - name: getdatasetsplitsapiv1datasetsdatasetidsplitsget
        method: GET
        description: Get Dataset Splits
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
          description: Only modifications made on or before this time are included. If None, the latest version of the dataset
            is used.
      - name: updatedatasetsplitsapiv1datasetsdatasetidsplitsput
        method: PUT
        description: Update Dataset Splits
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-tags
      path: /api/v1/datasets/{dataset_id}/tags
      operations:
      - name: updatedatasetversionapiv1datasetsdatasetidtagsput
        method: PUT
        description: Update Dataset Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-v1-datasets-dataset_id-version
      path: /api/v1/datasets/{dataset_id}/version
      operations:
      - name: getdatasetversionapiv1datasetsdatasetidversionget
        method: GET
        description: Get Dataset Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: as_of
          in: query
          type: string
        - name: tag
          in: query
          type: string
    - name: api-v1-datasets-dataset_id-versions
      path: /api/v1/datasets/{dataset_id}/versions
      operations:
      - name: getdatasetversionsapiv1datasetsdatasetidversionsget
        method: GET
        description: Get Dataset Versions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: search
          in: query
          type: string
        - name: example
          in: query
          type: string
        - name: limit
          in: query
          type: integer
        - name: offset
          in: query
          type: integer
    - name: api-v1-datasets-dataset_id-versions-diff
      path: /api/v1/datasets/{dataset_id}/versions/diff
      operations:
      - name: diffdatasetversionsapiv1datasetsdatasetidversionsdiffget
        method: GET
        description: Diff Dataset Versions
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dataset_id
          in: path
          type: string
          required: true
        - name: from_version
          in: query
          type: string
          required: true
        - name: to_version
          in: query
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.LANGSMITH_API_KEY}}'
  exposes:
  - type: rest
    namespace: langsmith-datasets-rest
    port: 8080
    description: REST adapter for LangSmith — datasets. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/api/v1/datasets
      name: api-v1-datasets
      description: REST surface for api-v1-datasets.
      operations:
      - method: GET
        name: readdatasetsapiv1datasetsget
        description: Read Datasets
        call: langsmith-datasets.readdatasetsapiv1datasetsget
        with:
          id: rest.id
          data_type: rest.data_type
          name: rest.name
          name_contains: rest.name_contains
          metadata: rest.metadata
          offset: rest.offset
          limit: rest.limit
          sort_by: rest.sort_by
          sort_by_desc: rest.sort_by_desc
          tag_value_id: rest.tag_value_id
          exclude_corrections_datasets: rest.exclude_corrections_datasets
          exclude: rest.exclude
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createdatasetapiv1datasetspost
        description: Create Dataset
        call: langsmith-datasets.createdatasetapiv1datasetspost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletedatasetsapiv1datasetsdelete
        description: Delete Datasets
        call: langsmith-datasets.deletedatasetsapiv1datasetsdelete
        with:
          dataset_ids: rest.dataset_ids
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/clone
      name: api-v1-datasets-clone
      description: REST surface for api-v1-datasets-clone.
      operations:
      - method: POST
        name: clonedatasetapiv1datasetsclonepost
        description: Clone Dataset
        call: langsmith-datasets.clonedatasetapiv1datasetsclonepost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/comparative
      name: api-v1-datasets-comparative
      description: REST surface for api-v1-datasets-comparative.
      operations:
      - method: POST
        name: createcomparativeexperimentapiv1datasetscomparativepost
        description: Create Comparative Experiment
        call: langsmith-datasets.createcomparativeexperimentapiv1datasetscomparativepost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/comparative/{comparative-experiment-id}
      name: api-v1-datasets-comparative-comparative-experiment-id
      description: REST surface for api-v1-datasets-comparative-comparative_experiment_id.
      operations:
      - method: DELETE
        name: deletecomparativeexperimentapiv1datasetscomparativecomparativeexperimentiddelete
        description: Delete Comparative Experiment
        call: langsmith-datasets.deletecomparativeexperimentapiv1datasetscomparativecomparativeexperimentiddelete
        with:
          comparative_experiment_id: rest.comparative_experiment_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/playground-experiment/batch
      name: api-v1-datasets-playground-experiment-batch
      description: REST surface for api-v1-datasets-playground_experiment-batch.
      operations:
      - method: POST
        name: datasethandlerapiv1datasetsplaygroundexperimentbatchpost
        description: Dataset Handler
        call: langsmith-datasets.datasethandlerapiv1datasetsplaygroundexperimentbatchpost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/playground-experiment/stream
      name: api-v1-datasets-playground-experiment-stream
      description: REST surface for api-v1-datasets-playground_experiment-stream.
      operations:
      - method: POST
        name: streamdatasethandlerapiv1datasetsplaygroundexperimentstreampost
        description: Stream Dataset Handler
        call: langsmith-datasets.streamdatasethandlerapiv1datasetsplaygroundexperimentstreampost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/stream
      name: api-v1-datasets-stream
      description: REST surface for api-v1-datasets-stream.
      operations:
      - method: GET
        name: readdatasetsstreamapiv1datasetsstreamget
        description: Read Datasets Stream
        call: langsmith-datasets.readdatasetsstreamapiv1datasetsstreamget
        with:
          id: rest.id
          data_type: rest.data_type
          name: rest.name
          name_contains: rest.name_contains
          metadata: rest.metadata
          offset: rest.offset
          limit: rest.limit
          sort_by: rest.sort_by
          sort_by_desc: rest.sort_by_desc
          tag_value_id: rest.tag_value_id
          exclude_corrections_datasets: rest.exclude_corrections_datasets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/studio-experiment
      name: api-v1-datasets-studio-experiment
      description: REST surface for api-v1-datasets-studio_experiment.
      operations:
      - method: POST
        name: studioexperimentapiv1datasetsstudioexperimentpost
        description: Studio Experiment
        call: langsmith-datasets.studioexperimentapiv1datasetsstudioexperimentpost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/upload
      name: api-v1-datasets-upload
      description: REST surface for api-v1-datasets-upload.
      operations:
      - method: POST
        name: uploadcsvdatasetapiv1datasetsuploadpost
        description: Upload Csv Dataset
        call: langsmith-datasets.uploadcsvdatasetapiv1datasetsuploadpost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/upload-experiment
      name: api-v1-datasets-upload-experiment
      description: REST surface for api-v1-datasets-upload-experiment.
      operations:
      - method: POST
        name: uploadexperimentapiv1datasetsuploadexperimentpost
        description: Upload Experiment
        call: langsmith-datasets.uploadexperimentapiv1datasetsuploadexperimentpost
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}
      name: api-v1-datasets-dataset-id
      description: REST surface for api-v1-datasets-dataset_id.
      operations:
      - method: GET
        name: readdatasetapiv1datasetsdatasetidget
        description: Read Dataset
        call: langsmith-datasets.readdatasetapiv1datasetsdatasetidget
        with:
          dataset_id: rest.dataset_id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletedatasetapiv1datasetsdatasetiddelete
        description: Delete Dataset
        call: langsmith-datasets.deletedatasetapiv1datasetsdatasetiddelete
        with:
          dataset_id: rest.dataset_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updatedatasetapiv1datasetsdatasetidpatch
        description: Update Dataset
        call: langsmith-datasets.updatedatasetapiv1datasetsdatasetidpatch
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/comparative
      name: api-v1-datasets-dataset-id-comparative
      description: REST surface for api-v1-datasets-dataset_id-comparative.
      operations:
      - method: GET
        name: readcomparativeexperimentsapiv1datasetsdatasetidcomparativeget
        description: Read Comparative Experiments
        call: langsmith-datasets.readcomparativeexperimentsapiv1datasetsdatasetidcomparativeget
        with:
          dataset_id: rest.dataset_id
          name: rest.name
          name_contains: rest.name_contains
          id: rest.id
          offset: rest.offset
          limit: rest.limit
          sort_by: rest.sort_by
          sort_by_desc: rest.sort_by_desc
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/csv
      name: api-v1-datasets-dataset-id-csv
      description: REST surface for api-v1-datasets-dataset_id-csv.
      operations:
      - method: GET
        name: downloaddatasetcsvapiv1datasetsdatasetidcsvget
        description: Download Dataset Csv
        call: langsmith-datasets.downloaddatasetcsvapiv1datasetsdatasetidcsvget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/experiments/grouped
      name: api-v1-datasets-dataset-id-experiments-grouped
      description: REST surface for api-v1-datasets-dataset_id-experiments-grouped.
      operations:
      - method: POST
        name: readgroupedexperimentsapiv1datasetsdatasetidexperimentsgroupedpost
        description: Read Grouped Experiments
        call: langsmith-datasets.readgroupedexperimentsapiv1datasetsdatasetidexperimentsgroupedpost
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/generate
      name: api-v1-datasets-dataset-id-generate
      description: REST surface for api-v1-datasets-dataset_id-generate.
      operations:
      - method: POST
        name: generateapiv1datasetsdatasetidgeneratepost
        description: Generate
        call: langsmith-datasets.generateapiv1datasetsdatasetidgeneratepost
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/group/runs
      name: api-v1-datasets-dataset-id-group-runs
      description: REST surface for api-v1-datasets-dataset_id-group-runs.
      operations:
      - method: POST
        name: readexampleswithrunsgroupedapiv1datasetsdatasetidgrouprunspost
        description: Read Examples With Runs Grouped
        call: langsmith-datasets.readexampleswithrunsgroupedapiv1datasetsdatasetidgrouprunspost
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/jsonl
      name: api-v1-datasets-dataset-id-jsonl
      description: REST surface for api-v1-datasets-dataset_id-jsonl.
      operations:
      - method: GET
        name: downloaddatasetjsonlapiv1datasetsdatasetidjsonlget
        description: Download Dataset Jsonl
        call: langsmith-datasets.downloaddatasetjsonlapiv1datasetsdatasetidjsonlget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/openai
      name: api-v1-datasets-dataset-id-openai
      description: REST surface for api-v1-datasets-dataset_id-openai.
      operations:
      - method: GET
        name: downloaddatasetopenaiapiv1datasetsdatasetidopenaiget
        description: Download Dataset Openai
        call: langsmith-datasets.downloaddatasetopenaiapiv1datasetsdatasetidopenaiget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/openai-ft
      name: api-v1-datasets-dataset-id-openai-ft
      description: REST surface for api-v1-datasets-dataset_id-openai_ft.
      operations:
      - method: GET
        name: downloaddatasetopenaiftapiv1datasetsdatasetidopenaiftget
        description: Download Dataset Openai Ft
        call: langsmith-datasets.downloaddatasetopenaiftapiv1datasetsdatasetidopenaiftget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/runs
      name: api-v1-datasets-dataset-id-runs
      description: REST surface for api-v1-datasets-dataset_id-runs.
      operations:
      - method: POST
        name: readexampleswithrunsapiv1datasetsdatasetidrunspost
        description: Read Examples With Runs
        call: langsmith-datasets.readexampleswithrunsapiv1datasetsdatasetidrunspost
        with:
          dataset_id: rest.dataset_id
          format: rest.format
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/runs/delta
      name: api-v1-datasets-dataset-id-runs-delta
      description: REST surface for api-v1-datasets-dataset_id-runs-delta.
      operations:
      - method: POST
        name: readdeltaapiv1datasetsdatasetidrunsdeltapost
        description: Read Delta
        call: langsmith-datasets.readdeltaapiv1datasetsdatasetidrunsdeltapost
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/runs/delta/stream
      name: api-v1-datasets-dataset-id-runs-delta-stream
      description: REST surface for api-v1-datasets-dataset_id-runs-delta-stream.
      operations:
      - method: POST
        name: readdeltastreamapiv1datasetsdatasetidrunsdeltastreampost
        description: Read Delta Stream
        call: langsmith-datasets.readdeltastreamapiv1datasetsdatasetidrunsdeltastreampost
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/share
      name: api-v1-datasets-dataset-id-share
      description: REST surface for api-v1-datasets-dataset_id-share.
      operations:
      - method: GET
        name: readdatasetsharestateapiv1datasetsdatasetidshareget
        description: Read Dataset Share State
        call: langsmith-datasets.readdatasetsharestateapiv1datasetsdatasetidshareget
        with:
          dataset_id: rest.dataset_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: sharedatasetapiv1datasetsdatasetidshareput
        description: Share Dataset
        call: langsmith-datasets.sharedatasetapiv1datasetsdatasetidshareput
        with:
          dataset_id: rest.dataset_id
          share_projects: rest.share_projects
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: unsharedatasetapiv1datasetsdatasetidsharedelete
        description: Unshare Dataset
        call: langsmith-datasets.unsharedatasetapiv1datasetsdatasetidsharedelete
        with:
          dataset_id: rest.dataset_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/splits
      name: api-v1-datasets-dataset-id-splits
      description: REST surface for api-v1-datasets-dataset_id-splits.
      operations:
      - method: GET
        name: getdatasetsplitsapiv1datasetsdatasetidsplitsget
        description: Get Dataset Splits
        call: langsmith-datasets.getdatasetsplitsapiv1datasetsdatasetidsplitsget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatedatasetsplitsapiv1datasetsdatasetidsplitsput
        description: Update Dataset Splits
        call: langsmith-datasets.updatedatasetsplitsapiv1datasetsdatasetidsplitsput
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/tags
      name: api-v1-datasets-dataset-id-tags
      description: REST surface for api-v1-datasets-dataset_id-tags.
      operations:
      - method: PUT
        name: updatedatasetversionapiv1datasetsdatasetidtagsput
        description: Update Dataset Version
        call: langsmith-datasets.updatedatasetversionapiv1datasetsdatasetidtagsput
        with:
          dataset_id: rest.dataset_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/version
      name: api-v1-datasets-dataset-id-version
      description: REST surface for api-v1-datasets-dataset_id-version.
      operations:
      - method: GET
        name: getdatasetversionapiv1datasetsdatasetidversionget
        description: Get Dataset Version
        call: langsmith-datasets.getdatasetversionapiv1datasetsdatasetidversionget
        with:
          dataset_id: rest.dataset_id
          as_of: rest.as_of
          tag: rest.tag
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/versions
      name: api-v1-datasets-dataset-id-versions
      description: REST surface for api-v1-datasets-dataset_id-versions.
      operations:
      - method: GET
        name: getdatasetversionsapiv1datasetsdatasetidversionsget
        description: Get Dataset Versions
        call: langsmith-datasets.getdatasetversionsapiv1datasetsdatasetidversionsget
        with:
          dataset_id: rest.dataset_id
          search: rest.search
          example: rest.example
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/datasets/{dataset-id}/versions/diff
      name: api-v1-datasets-dataset-id-versions-diff
      description: REST surface for api-v1-datasets-dataset_id-versions-diff.
      operations:
      - method: GET
        name: diffdatasetversionsapiv1datasetsdatasetidversionsdiffget
        description: Diff Dataset Versions
        call: langsmith-datasets.diffdatasetversionsapiv1datasetsdatasetidversionsdiffget
        with:
          dataset_id: rest.dataset_id
          from_version: rest.from_version
          to_version: rest.to_version
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: langsmith-datasets-mcp
    port: 9090
    transport: http
    description: MCP adapter for LangSmith — datasets. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: read-datasets
      description: Read Datasets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.readdatasetsapiv1datasetsget
      with:
        id: tools.id
        data_type: tools.data_type
        name: tools.name
        name_contains: tools.name_contains
        metadata: tools.metadata
        offset: tools.offset
        limit: tools.limit
        sort_by: tools.sort_by
        sort_by_desc: tools.sort_by_desc
        tag_value_id: tools.tag_value_id
        exclude_corrections_datasets: tools.exclude_corrections_datasets
        exclude: tools.exclude
      outputParameters:
      - type: object
        mapping: $.
    - name: create-dataset
      description: Create Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.createdatasetapiv1datasetspost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-datasets
      description: Delete Datasets
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: langsmith-datasets.deletedatasetsapiv1datasetsdelete
      with:
        dataset_ids: tools.dataset_ids
      outputParameters:
      - type: object
        mapping: $.
    - name: clone-dataset
      description: Clone Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.clonedatasetapiv1datasetsclonepost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: create-comparative-experiment
      description: Create Comparative Experiment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.createcomparativeexperimentapiv1datasetscomparativepost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-comparative-experiment
      description: Delete Comparative Experiment
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: langsmith-datasets.deletecomparativeexperimentapiv1datasetscomparativecomparativeexperimentiddelete
      with:
        comparative_experiment_id: tools.comparative_experiment_id
      outputParameters:
      - type: object
        mapping: $.
    - name: dataset-handler
      description: Dataset Handler
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.datasethandlerapiv1datasetsplaygroundexperimentbatchpost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: stream-dataset-handler
      description: Stream Dataset Handler
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.streamdatasethandlerapiv1datasetsplaygroundexperimentstreampost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-datasets-stream
      description: Read Datasets Stream
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.readdatasetsstreamapiv1datasetsstreamget
      with:
        id: tools.id
        data_type: tools.data_type
        name: tools.name
        name_contains: tools.name_contains
        metadata: tools.metadata
        offset: tools.offset
        limit: tools.limit
        sort_by: tools.sort_by
        sort_by_desc: tools.sort_by_desc
        tag_value_id: tools.tag_value_id
        exclude_corrections_datasets: tools.exclude_corrections_datasets
      outputParameters:
      - type: object
        mapping: $.
    - name: studio-experiment
      description: Studio Experiment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.studioexperimentapiv1datasetsstudioexperimentpost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: upload-csv-dataset
      description: Upload Csv Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.uploadcsvdatasetapiv1datasetsuploadpost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: upload-experiment
      description: Upload Experiment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.uploadexperimentapiv1datasetsuploadexperimentpost
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-dataset
      description: Read Dataset
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.readdatasetapiv1datasetsdatasetidget
      with:
        dataset_id: tools.dataset_id
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-dataset
      description: Delete Dataset
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: langsmith-datasets.deletedatasetapiv1datasetsdatasetiddelete
      with:
        dataset_id: tools.dataset_id
      outputParameters:
      - type: object
        mapping: $.
    - name: update-dataset
      description: Update Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: langsmith-datasets.updatedatasetapiv1datasetsdatasetidpatch
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-comparative-experiments
      description: Read Comparative Experiments
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.readcomparativeexperimentsapiv1datasetsdatasetidcomparativeget
      with:
        dataset_id: tools.dataset_id
        name: tools.name
        name_contains: tools.name_contains
        id: tools.id
        offset: tools.offset
        limit: tools.limit
        sort_by: tools.sort_by
        sort_by_desc: tools.sort_by_desc
      outputParameters:
      - type: object
        mapping: $.
    - name: download-dataset-csv
      description: Download Dataset Csv
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.downloaddatasetcsvapiv1datasetsdatasetidcsvget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
      outputParameters:
      - type: object
        mapping: $.
    - name: read-grouped-experiments
      description: Read Grouped Experiments
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.readgroupedexperimentsapiv1datasetsdatasetidexperimentsgroupedpost
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: generate
      description: Generate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.generateapiv1datasetsdatasetidgeneratepost
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-examples-runs-grouped
      description: Read Examples With Runs Grouped
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.readexampleswithrunsgroupedapiv1datasetsdatasetidgrouprunspost
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: download-dataset-jsonl
      description: Download Dataset Jsonl
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.downloaddatasetjsonlapiv1datasetsdatasetidjsonlget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
      outputParameters:
      - type: object
        mapping: $.
    - name: download-dataset-openai
      description: Download Dataset Openai
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.downloaddatasetopenaiapiv1datasetsdatasetidopenaiget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
      outputParameters:
      - type: object
        mapping: $.
    - name: download-dataset-openai-ft
      description: Download Dataset Openai Ft
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.downloaddatasetopenaiftapiv1datasetsdatasetidopenaiftget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
      outputParameters:
      - type: object
        mapping: $.
    - name: read-examples-runs
      description: Read Examples With Runs
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.readexampleswithrunsapiv1datasetsdatasetidrunspost
      with:
        dataset_id: tools.dataset_id
        format: tools.format
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-delta
      description: Read Delta
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.readdeltaapiv1datasetsdatasetidrunsdeltapost
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-delta-stream
      description: Read Delta Stream
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: langsmith-datasets.readdeltastreamapiv1datasetsdatasetidrunsdeltastreampost
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: read-dataset-share-state
      description: Read Dataset Share State
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.readdatasetsharestateapiv1datasetsdatasetidshareget
      with:
        dataset_id: tools.dataset_id
      outputParameters:
      - type: object
        mapping: $.
    - name: share-dataset
      description: Share Dataset
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: langsmith-datasets.sharedatasetapiv1datasetsdatasetidshareput
      with:
        dataset_id: tools.dataset_id
        share_projects: tools.share_projects
      outputParameters:
      - type: object
        mapping: $.
    - name: unshare-dataset
      description: Unshare Dataset
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: langsmith-datasets.unsharedatasetapiv1datasetsdatasetidsharedelete
      with:
        dataset_id: tools.dataset_id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-dataset-splits
      description: Get Dataset Splits
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.getdatasetsplitsapiv1datasetsdatasetidsplitsget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
      outputParameters:
      - type: object
        mapping: $.
    - name: update-dataset-splits
      description: Update Dataset Splits
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: langsmith-datasets.updatedatasetsplitsapiv1datasetsdatasetidsplitsput
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: update-dataset-version
      description: Update Dataset Version
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: langsmith-datasets.updatedatasetversionapiv1datasetsdatasetidtagsput
      with:
        dataset_id: tools.dataset_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-dataset-version
      description: Get Dataset Version
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.getdatasetversionapiv1datasetsdatasetidversionget
      with:
        dataset_id: tools.dataset_id
        as_of: tools.as_of
        tag: tools.tag
      outputParameters:
      - type: object
        mapping: $.
    - name: get-dataset-versions
      description: Get Dataset Versions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.getdatasetversionsapiv1datasetsdatasetidversionsget
      with:
        dataset_id: tools.dataset_id
        search: tools.search
        example: tools.example
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: diff-dataset-versions
      description: Diff Dataset Versions
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: langsmith-datasets.diffdatasetversionsapiv1datasetsdatasetidversionsdiffget
      with:
        dataset_id: tools.dataset_id
        from_version: tools.from_version
        to_version: tools.to_version
      outputParameters:
      - type: object
        mapping: $.