---
title: "PATCH /datasets/{name}/versions/{version}"
method: PATCH
path: "/datasets/{name}/versions/{version}"
---

# PATCH /datasets/{name}/versions/{version}

`PATCH /datasets/{name}/versions/{version}`

Create a new or update an existing DatasetVersion with the given version id

## Path parameters

- `name` string, required
- `version` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The request has succeeded.

- DatasetVersion — DatasetVersion Definition
  - `dataUri` string, required — URI of the data ([example](https://go.microsoft.com/fwlink/?linkid=2202330))
  - `type` 'uri_file' | 'uri_folder', required — Enum to determine the type of data.
  - `isReference` boolean — Indicates if the dataset holds a reference to the storage, or the dataset manages storage itself. If true, the underlying data will not be deleted when the dataset version is deleted
  - `connectionName` string — The Azure Storage Account connection name. Required if startPendingUploadVersion was not called before creating the Dataset
  - `id` string — Asset ID, a unique identifier for the asset
  - `name` string, required — The name of the resource
  - `version` string, required — The version of the resource
  - `description` string — The asset description text.
  - `tags` object — Tag dictionary. Tags can be added, removed, and updated.

## Other responses

- `201` — The request has succeeded and a new resource has been created as a result.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/ai-azure-ai-projects.md) · [All operations](https://skmtc.net/azure/apis/ai-azure-ai-projects/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/ai-azure-ai-projects/versions/b52c14a89ea1/schema)