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

# POST /datasets/{name}/versions/{version}/startPendingUpload

`POST /datasets/{name}/versions/{version}/startPendingUpload`

Start a new or get an existing pending upload of a dataset for a specific version.

## Path parameters

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

## Query parameters

- `api-version` string, required

## Request body

- PendingUploadRequest — Represents a request for a pending upload.
  - `pendingUploadId` string — If PendingUploadId is not provided, a random GUID will be used.
  - `connectionName` string — Azure Storage Account connection name to use for generating temporary SAS token
  - `pendingUploadType` 'BlobReference', required — BlobReference is the only supported type.

## Response `200`

The request has succeeded.

- PendingUploadResponse — Represents the response for a pending upload request
  - `blobReference` BlobReference, required — Blob reference details.
    - `blobUri` string, required — Blob URI path for client to upload data. Example: `https://blob.windows.core.net/Container/Path`
    - `storageAccountArmId` string, required — ARM ID of the storage account to use.
    - `credential` SasCredential, required — SAS Credential definition
      - `sasUri` string, required — SAS uri
      - `type` 'SAS', required — Type of credential
  - `pendingUploadId` string, required — ID for this upload request.
  - `version` string — Version of asset to be created if user did not specify version when initially creating upload
  - `pendingUploadType` 'BlobReference', required — BlobReference is the only supported type

## Other responses

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