---
title: "Update Dataset"
method: PATCH
path: "/api/v1/datasets/{dataset_id}"
tags: ["datasets"]
---

# Update Dataset

`PATCH /api/v1/datasets/{dataset_id}`

Update a specific dataset.

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- DatasetUpdate — Update class for Dataset.
  - `name` union
    - string
    - Missing
      - `__missing__` '__missing__', required
  - `description` union
    - string
    - Missing
      - `__missing__` '__missing__', required
  - `inputs_schema_definition` union
    - object
    - Missing
      - `__missing__` '__missing__', required
  - `outputs_schema_definition` union
    - object
    - Missing
      - `__missing__` '__missing__', required
  - `patch_examples` object, nullable
  - `transformations` union
    - DatasetTransformation[]
      - `path` string[], required
      - `transformation_type` 'convert_to_openai_message' | 'convert_to_openai_tool' | 'remove_system_messages' | 'remove_extra_fields' | 'extract_tools_from_run', required — Enum for dataset transformation types. Ordering determines the order in which transformations are applied if there are multiple transformations on the same path.
    - Missing
      - `__missing__` '__missing__', required
  - `metadata` union
    - object
    - Missing
      - `__missing__` '__missing__', required
  - `baseline_experiment_id` union
    - string, uuid
    - Missing
      - `__missing__` '__missing__', required

## Response `200`

Dataset updated successfully

- DatasetSchemaForUpdate
  - `name` string, required
  - `description` string, nullable
  - `created_at` string, date-time
  - `inputs_schema_definition` object, nullable
  - `outputs_schema_definition` object, nullable
  - `externally_managed` boolean, nullable
  - `transformations` DatasetTransformation[], nullable
    - `path` string[], required
    - `transformation_type` 'convert_to_openai_message' | 'convert_to_openai_tool' | 'remove_system_messages' | 'remove_extra_fields' | 'extract_tools_from_run', required — Enum for dataset transformation types. Ordering determines the order in which transformations are applied if there are multiple transformations on the same path.
  - `data_type` 'kv' | 'llm' | 'chat' — Enum for dataset data types.
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/versions/a0acb3a6a101/schema)