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

# Update a dataset

`PATCH /datasets/{dataset_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/datasets/{dataset_id}`
- Auth: HTTP bearer

Update a dataset

## Path parameters

- `dataset_id` string, required

## Request body

- DatasetUpdate
  - `customFields` CustomFields
  - `folderId` string: ID of the folder that contains the file
  - `name` string: New display name for the dataset

## Response `200`

OK

- Dataset
  - `archiveRecord` ArchiveRecord
    - `reason` string
  - `createdAt` string, date-time: Date and time the dataset was created
  - `creator` DatasetCreator: UserSummary of the user who created the dataset
    - `handle` string
    - `id` string
    - `name` string
  - `customFields` CustomFields
  - `dataFrameId` string: ID of the data frame to link to this dataset
  - `displayId` string: User-friendly ID of the dataset
  - `folderId` string: ID of the folder that contains the dataset
  - `id` string
  - `modifiedAt` string, date-time: Date and time the dataset was last modified
  - `name` string: The user-facing name for this Dataset.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)