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

# Update Dataset

`PATCH /datasets/{dataset_id}`

## Path parameters

- `dataset_id` string, uuid, required

## Request body

- DatasetUpdate
  - `name` string, nullable — Dataset name
  - `guidelines` string, nullable — Dataset guidelines
  - `allow_extra_metadata` boolean, nullable
  - `distribution` DatasetOverlapDistributionUpdate
    - `strategy` 'overlap', required
    - `min_submitted` integer, required — Minimum number of submitted responses to consider a record as completed
  - `metadata` object, nullable

## Response `200`

Successful Response

- Dataset
  - `id` string, uuid, required
  - `name` string, required
  - `guidelines` string, nullable
  - `allow_extra_metadata` boolean, required
  - `status` 'draft' | 'ready', required
  - `distribution` DatasetOverlapDistribution, required
    - `strategy` 'overlap', required
    - `min_submitted` integer, required
  - `metadata` object, nullable
  - `mapping` DatasetMapping
    - `fields` DatasetMappingItem[], required
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `metadata` DatasetMappingItem[], nullable
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `suggestions` DatasetMappingItem[], nullable
      - `source` string, required — The name of the column in the Hub Dataset
      - `target` string, required — The name of the target resource in the Extralit Dataset
    - `source_id` string, nullable — Dataset-level source identifier (format: import:{import_id}, dataset:{dataset_id}, hub:{repo_id})
    - `target_id` string, nullable — Dataset-level target identifier for workflow tracking
  - `workspace_id` string, uuid, required
  - `last_activity_at` string, date-time, required
  - `inserted_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/versions/3ebd7ae94c89/schema)