---
title: "Update a data frame"
method: PATCH
path: "/data-frames/{data_frame_id}"
tags: ["dataFrames"]
---

# Update a data frame

`PATCH /data-frames/{data_frame_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/data-frames/{data_frame_id}`
- Auth: HTTP bearer

Update a data frame.

After uploading a `.csv` data drame file to S3, call this endpoint to mark the upload status as `IN_PROGRESS`
to launch a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) to validate and transform the raw `.csv` file into a
data frame. Once complete, the data frame's status will either be updated to `SUCCEEDED` or `FAILED_VALIDATION`.

For more details on how we process and validate data frames, [click here](https://docs.benchling.com/docs/datasets-ingestion-reference).

See [Create a data frame](https://docs.benchling.com/docs/api/v2/benchling-api/data-frames/create-data-frame) for documentation of the full upload flow.

## Path parameters

- `data_frame_id` string, required

## Request body

- DataFrameUpdate
  - `uploadStatus` 'IN_PROGRESS'

## Response `202`

This endpoint launches a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) and returns the Task ID of the launched task.
When successful, the task returns the `DataFrame` resource for the related data frame.

- AsyncTaskLink
  - `taskId` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

---

[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)