---
title: "Update a dataset"
method: POST
path: "/v4/datasets/{id}"
tags: ["Datasets"]
---

# Update a dataset

`POST /v4/datasets/{id}`

Update the details of a dataset by ID

## Path parameters

- `id` string, uuid, required — Dataset UUID

## Request body

- UpdateDataset
  - `name` string — Dataset name
  - `description` string, nullable — Dataset description
  - `isGolden` boolean — Set the dataset as the golden dataset
  - `isArchived` boolean — Archive the dataset

## Response `200`

Successful response

- Dataset
  - `id` string, uuid, required — Dataset UUID
  - `createdAt` string, required — Creation timestamp (ISO 8601)
  - `updatedAt` string, required — Last update timestamp (ISO 8601)
  - `name` string, required — Dataset name
  - `description` string, nullable, required — Dataset description
  - `archivedAt` string, nullable, required — Archive timestamp (ISO 8601)
  - `pipelineId` string, required — Pipeline UUID

## Other responses

- `400` — Client provided an invalid request for the dataset. Please check the request format and parameters.
- `401` — No valid API key provided.
- `404` — The dataset resource does not exist.
- `500` — Something went wrong on Gentrace's end.

## Changes

- **2025-04-28** `76bde656b16e` — 3 breaking, 1 info
  - the `archivedAt` response's property type/format changed from `string, null`/`date-time` to `string, null`/`` for status `200`
  - the `createdAt` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `updatedAt` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `name` request property's minLength was decreased from `1` to `0`
- **2025-04-22** `610091298e37` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gentrace/apis/gentrace-api/changes/v4/datasets/:id/post.md)

---

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