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

# Update dataset metadata

`PATCH /dataset/{dataset_id}`

## Request

- Base URL: `https://api.indexone.io`
- URL: `https://api.indexone.io/dataset/{dataset_id}`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

Updates a dataset's metadata. Only `name` and `description` may be changed; everything else on the record is an identifier or derived from one (`s3_url` and `url` embed the dataset id), so changing them would orphan the stored objects.

The team record holds a full copy of each dataset, written once at creation. This endpoint rewrites that copy too, so a rename is reflected everywhere the team map is read. Data changes still go through `POST /dataset/{dataset_id}/mutation`.

Added 2026-07-21.

## Path parameters

- `dataset_id` string, required

## Request body

- object
  - `name` string
  - `description` string

## Response `200`

Intended response: the updated dataset record.

- object

## Other responses

- `401`: Missing or invalid id token.
- `403`: Caller's teams do not own this dataset.
- `404`: No such dataset.
- `429`: API key usage-plan rate limit exceeded.

---

[API](https://skmtc.dev/indexone/apis/index-one-rest-api.md) · [All operations](https://skmtc.dev/indexone/apis/index-one-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indexone/apis/index-one-rest-api/revisions/df5a92216a9c?raw)
