LangWatch · Capability

LangWatch Datasets API

Manage evaluation/fine-tuning datasets and their records. Self-contained Naftiko capability covering one LangWatch business surface.

LangWatch Datasets API is a Naftiko capability published by LangWatch, one of 20 capabilities the APIs.io network indexes for this provider. It bundles 12 operations across the POST, GET, PATCH, and DELETE methods rooted at /v1/api/dataset.

The capability includes 3 read-only operations and 9 state-changing operations. Lead operation: List datasets. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include LangWatch, Datasets, and Records.

Run with Naftiko LangWatchDatasetsRecords

What You Can Do

GET
Listdatasets — List datasets.
/v1/api/dataset
POST
Createdataset — Create a dataset.
/v1/api/dataset
POST
Uploaddataset — Upload a CSV dataset.
/v1/api/dataset/upload
GET
Getdataset — Get a dataset.
/v1/api/dataset/{slugOrId}
PATCH
Updatedataset — Update a dataset.
/v1/api/dataset/{slugOrId}
DELETE
Deletedataset — Delete a dataset.
/v1/api/dataset/{slugOrId}
GET
Listrecords — List dataset records.
/v1/api/dataset/{slugOrId}/records
POST
Createrecords — Create dataset records.
/v1/api/dataset/{slugOrId}/records
DELETE
Deleterecords — Delete dataset records.
/v1/api/dataset/{slugOrId}/records
PATCH
Updaterecord — Update a dataset record.
/v1/api/dataset/{slugOrId}/records/{recordId}
POST
Uploadintodataset — Upload rows into a dataset.
/v1/api/dataset/{slugOrId}/upload
POST
Appendentries — Append entries to a dataset.
/v1/api/dataset/{slug}/entries

MCP Tools

langwatch-listDatasets

List datasets.

read-only idempotent
langwatch-createDataset

Create a dataset.

langwatch-uploadDataset

Upload a CSV dataset.

langwatch-getDataset

Get a dataset.

read-only idempotent
langwatch-updateDataset

Update a dataset.

langwatch-deleteDataset

Delete a dataset.

idempotent
langwatch-listRecords

List dataset records.

read-only idempotent
langwatch-createRecords

Create dataset records.

langwatch-deleteRecords

Delete dataset records.

idempotent
langwatch-updateRecord

Update a dataset record.

langwatch-uploadIntoDataset

Upload rows into a dataset.

langwatch-appendEntries

Append entries to a dataset.

Capability Spec

datasets.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: LangWatch Datasets API
  description: 'Manage evaluation/fine-tuning datasets and their records. Self-contained Naftiko capability covering one LangWatch business surface.'
  tags:
  - LangWatch
  - Datasets
  - Records
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    LANGWATCH_API_KEY: LANGWATCH_API_KEY
capability:
  consumes:
  - type: http
    namespace: datasets
    baseUri: https://app.langwatch.ai
    description: Manage evaluation/fine-tuning datasets and their records.
    resources:
    - name: api-dataset
      path: /api/dataset
      operations:
      - name: listDatasets
        method: GET
        description: List datasets.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createDataset
        method: POST
        description: Create a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-dataset-upload
      path: /api/dataset/upload
      operations:
      - name: uploadDataset
        method: POST
        description: Upload a CSV dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-dataset-slugorid
      path: /api/dataset/{slugOrId}
      operations:
      - name: getDataset
        method: GET
        description: Get a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
      - name: updateDataset
        method: PATCH
        description: Update a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteDataset
        method: DELETE
        description: Delete a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
    - name: api-dataset-slugorid-records
      path: /api/dataset/{slugOrId}/records
      operations:
      - name: listRecords
        method: GET
        description: List dataset records.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
      - name: createRecords
        method: POST
        description: Create dataset records.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteRecords
        method: DELETE
        description: Delete dataset records.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
    - name: api-dataset-slugorid-records-recordid
      path: /api/dataset/{slugOrId}/records/{recordId}
      operations:
      - name: updateRecord
        method: PATCH
        description: Update a dataset record.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
        - name: recordId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-dataset-slugorid-upload
      path: /api/dataset/{slugOrId}/upload
      operations:
      - name: uploadIntoDataset
        method: POST
        description: Upload rows into a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slugOrId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-dataset-slug-entries
      path: /api/dataset/{slug}/entries
      operations:
      - name: appendEntries
        method: POST
        description: Append entries to a dataset.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: slug
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: bearer
      value: '{{env.LANGWATCH_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: datasets-rest
    port: 8080
    description: REST adapter for LangWatch Datasets API.
    resources:
    - path: /v1/api/dataset
      name: listdatasets-resource
      description: REST surface for listDatasets.
      operations:
      - method: GET
        name: listDatasets
        description: List datasets.
        call: datasets.listDatasets
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset
      name: createdataset-resource
      description: REST surface for createDataset.
      operations:
      - method: POST
        name: createDataset
        description: Create a dataset.
        call: datasets.createDataset
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/upload
      name: uploaddataset-resource
      description: REST surface for uploadDataset.
      operations:
      - method: POST
        name: uploadDataset
        description: Upload a CSV dataset.
        call: datasets.uploadDataset
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}
      name: getdataset-resource
      description: REST surface for getDataset.
      operations:
      - method: GET
        name: getDataset
        description: Get a dataset.
        call: datasets.getDataset
        with:
          slugOrId: rest.path.slugOrId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}
      name: updatedataset-resource
      description: REST surface for updateDataset.
      operations:
      - method: PATCH
        name: updateDataset
        description: Update a dataset.
        call: datasets.updateDataset
        with:
          slugOrId: rest.path.slugOrId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}
      name: deletedataset-resource
      description: REST surface for deleteDataset.
      operations:
      - method: DELETE
        name: deleteDataset
        description: Delete a dataset.
        call: datasets.deleteDataset
        with:
          slugOrId: rest.path.slugOrId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}/records
      name: listrecords-resource
      description: REST surface for listRecords.
      operations:
      - method: GET
        name: listRecords
        description: List dataset records.
        call: datasets.listRecords
        with:
          slugOrId: rest.path.slugOrId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}/records
      name: createrecords-resource
      description: REST surface for createRecords.
      operations:
      - method: POST
        name: createRecords
        description: Create dataset records.
        call: datasets.createRecords
        with:
          slugOrId: rest.path.slugOrId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}/records
      name: deleterecords-resource
      description: REST surface for deleteRecords.
      operations:
      - method: DELETE
        name: deleteRecords
        description: Delete dataset records.
        call: datasets.deleteRecords
        with:
          slugOrId: rest.path.slugOrId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}/records/{recordId}
      name: updaterecord-resource
      description: REST surface for updateRecord.
      operations:
      - method: PATCH
        name: updateRecord
        description: Update a dataset record.
        call: datasets.updateRecord
        with:
          slugOrId: rest.path.slugOrId
          recordId: rest.path.recordId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slugOrId}/upload
      name: uploadintodataset-resource
      description: REST surface for uploadIntoDataset.
      operations:
      - method: POST
        name: uploadIntoDataset
        description: Upload rows into a dataset.
        call: datasets.uploadIntoDataset
        with:
          slugOrId: rest.path.slugOrId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/dataset/{slug}/entries
      name: appendentries-resource
      description: REST surface for appendEntries.
      operations:
      - method: POST
        name: appendEntries
        description: Append entries to a dataset.
        call: datasets.appendEntries
        with:
          slug: rest.path.slug
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: datasets-mcp
    port: 9090
    transport: http
    description: MCP adapter for LangWatch Datasets API. One tool per consumed operation.
    tools:
    - name: langwatch-listDatasets
      description: List datasets.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasets.listDatasets
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-createDataset
      description: Create a dataset.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.createDataset
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-uploadDataset
      description: Upload a CSV dataset.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.uploadDataset
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-getDataset
      description: Get a dataset.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasets.getDataset
      with:
        slugOrId: tools.slugOrId
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-updateDataset
      description: Update a dataset.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.updateDataset
      with:
        slugOrId: tools.slugOrId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-deleteDataset
      description: Delete a dataset.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: datasets.deleteDataset
      with:
        slugOrId: tools.slugOrId
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-listRecords
      description: List dataset records.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: datasets.listRecords
      with:
        slugOrId: tools.slugOrId
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-createRecords
      description: Create dataset records.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.createRecords
      with:
        slugOrId: tools.slugOrId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-deleteRecords
      description: Delete dataset records.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: datasets.deleteRecords
      with:
        slugOrId: tools.slugOrId
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-updateRecord
      description: Update a dataset record.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.updateRecord
      with:
        slugOrId: tools.slugOrId
        recordId: tools.recordId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-uploadIntoDataset
      description: Upload rows into a dataset.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.uploadIntoDataset
      with:
        slugOrId: tools.slugOrId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: langwatch-appendEntries
      description: Append entries to a dataset.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: datasets.appendEntries
      with:
        slug: tools.slug
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.