---
title: "Update a dataset"
method: PATCH
path: "/v2/datasets/{dataset_id}"
tags: ["Datasets"]
---

# Update a dataset

`PATCH /v2/datasets/{dataset_id}`

Update a dataset

## Path parameters

- `dataset_id` union, required — The unique identifier of the dataset
  - string
  - string, ulid — The id of the resource

## Request body

- object
  - `display_name` string — The display name of the dataset
  - `project_id` union — The unique identifier of the project it belongs to
    - string
    - string, ulid — The id of the resource
  - `path` string — Entity storage path. With workspace-level API keys, use the format `project/folder/subfolder/...`. The first element must be the display name of an existing project, followed by nested folders (auto-created as needed). Example: `Default Project/agents`. With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: `agents`. For backward compatibility, a leading project name is ignored when it matches the scoped project.

## Response `200`

Dataset updated.

- object
  - `_id` union, required — The unique identifier of the dataset
    - string
    - string, ulid — The id of the resource
  - `display_name` string, required — The display name of the dataset
  - `project_id` union, required — The unique identifier of the project it belongs to
    - string
    - string, ulid — The id of the resource
  - `workspace_id` union, required — The unique identifier of the workspace it belongs to
    - string
    - string, ulid — The id of the resource
  - `metadata` object, required
    - `total_versions` number, required
    - `datapoints_count` number, required
  - `created_by_id` union — The unique identifier of the user who created the dataset
    - string
    - string, ulid — The id of the resource
  - `updated_by_id` union — The unique identifier of the user who last updated the dataset
    - string
    - string, ulid — The id of the resource
  - `created` union — The date and time the resource was created
    - string, date-time
    - string, date-time
  - `updated` union — The date and time the resource was last updated
    - string, date-time
    - string, date-time

## Other responses

- `404` — Dataset not found with the given id

## Changes

> 247 revisions in range; 71 not diffed.

- **2026-08-26** `1f8d6c19ffa2` — 2 info
  - the `` response's property default value changed from `2026-08-26T13:17:17.478Z` to `2026-08-26T13:26:42.563Z` for the status `200`
  - the `created` response's property default value changed from `2026-08-26T13:17:17.477Z` to `2026-08-26T13:26:42.562Z` for the status `200`
- **2026-08-26** `34cb457678d2` — 2 info
  - the `` response's property default value changed from `2026-08-26T11:10:52.849Z` to `2026-08-26T13:17:17.478Z` for the status `200`
  - the `created` response's property default value changed from `2026-08-26T11:10:52.848Z` to `2026-08-26T13:17:17.477Z` for the status `200`
- **2026-08-26** `32cce7a5d007` — 2 info
  - the `` response's property default value changed from `2026-08-26T09:46:50.254Z` to `2026-08-26T11:10:52.849Z` for the status `200`
  - the `created` response's property default value changed from `2026-08-26T09:46:50.253Z` to `2026-08-26T11:10:52.848Z` for the status `200`
- **2026-08-26** `37cda3ee179b` — 2 info
  - the `` response's property default value changed from `2026-08-26T07:29:36.190Z` to `2026-08-26T09:46:50.254Z` for the status `200`
  - the `created` response's property default value changed from `2026-08-26T07:29:36.189Z` to `2026-08-26T09:46:50.253Z` for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/datasets/:dataset_id/patch.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/1f8d6c19ffa2/schema)