vaults/{vaultId}/file-uploads/{uploadId}/parts/{partIndex}
Appends one raw file-content part. Clients may use the file MIME type as Content-Type; Vault does not use this header to determine the file type. Multipart form bodies are rejected with 415 because their boundaries are not file content. Start with partIndex 0 and send the uploadSessionToken returned by each successful response in the X-Vault-Upload-Session header. The underlying Filestore upload is append-only, so clients must restart the upload after an unknown network outcome instead of replaying a part.
Resource Information
| Method and URI | PUT /AutodeskDM/Services/api/vault/v2/vaults/{vaultId}/file-uploads/{uploadId}/parts/{partIndex} |
| Authentication Context | User context required |
| Required OAuth Scopes | No scopes required |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is a three-legged access token obtained via an Authorization Code flow or a Secure Service Account (SSA) flow.
The SSA flow is designed for headless server-to-server operations. While it functions like a two-legged flow (no user interaction), it is classified as three-legged because it preserves user context. |
| X-Vault-Upload-Session* string | The opaque continuation token returned by the previous upload response. |
| Content-Type* string | Must be */* |
Request
URI Parameters
| vaultId string | The unique identifier of a Knowledge Vault. |
| uploadId string: UUID | The stable identifier of the upload session. |
| partIndex int | Zero-based sequential part index. |
Request
Body Structure
Response
HTTP Status Code Summary
| 200 OK | The file content part was successfully appended. |
| 400 Bad Request | The server was unable to process the request. The syntax of the request is malformed or the request is missing a required header. Do not repeat the request without fixing the issue. The response body may indicate what is wrong with the request. |
| 401 Unauthorized | The supplied authorization header was not valid or the supplied token scope was not acceptable. Verify authentication and try again. |
| 403 Forbidden | The request was successfully validated but lacking the required permissions. Verify your credentials and permissions before you send this request again. |
| 411 | The Content-Length header is required. |
| 415 | Multipart form bodies are not supported. Send the raw file bytes as the request body. |
Response
Body Structure (200)
| uploadId string: UUID | Stable identifier of the upload session. |
| uploadSessionToken string | Opaque continuation token. Send this value in the X-Vault-Upload-Session header for the next part upload or completion request. |
| state enum:string | Possible values: open, uploading |
| maxPartSize int | Maximum accepted size of one content part in bytes. |
| totalBytes int | Total content bytes successfully appended to this upload session. |
Example
This example illustrates how to upload one raw content part to an open file upload session.
Note: {VaultServerAddress} is used as a placeholder in the example(s) and could represent one of the following:
- Vault Server IP address or hostname. Ex: http://10.41.110.49.
- Vault Gateway URL if gateway is configured. Ex: https://test.vg.autodesk.com.
Request
curl -v '{VaultServerAddress}/AutodeskDM/Services/api/vault/v2/vaults/9/file-uploads/2e3a6deb-7480-4c2c-a5cf-17a48522590d/parts/0' \
-X 'PUT' \
-H 'Content-Type: application/octet-stream'\
-H 'Content-Length: 33'\
-H 'X-Vault-Upload-Session: y75f-k~TOvDdLtkKm6wn5KvqG8X-u4qOjuFkWD2zbH6nL0V5VYIXkkmMUhu2U1nffsAvJZYrtNBlgamJExBlzO1dcjLZzu9kCHyNbCPauITUL4PyHpnA6VzqGS4BscHuvWICTIdLb2Hn8sWedDqOcRoBTRBOjrAjCFGGp7gj5lqKQqjMmDfNX2T5I4rJPA6Koxmsyf61sc84w-f92Vl8HagF03D40pyg9WNl4b1~UMF5DdSQp8TJlwdCwhULGpE79s0pjX2Xf9IaUevjq-l6audl8~AZEUg8cSMTu9waML~P5s3UdmOHmTQ2K6p3dgM8AlTc5oj8jtDbK1yfMpq63iT0a7xEc4~~WCF8jL9nGVFfM9vxgjevgaj7Gr2YR~k3'\
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a...'\
--data-binary @Bracket.ipt.part0
Response
{
"uploadId": "2e3a6deb-7480-4c2c-a5cf-17a48522590d",
"uploadSessionToken": "y75f-k~TOvDdLtkKm6wn5KvqG8X-u4qOjuFkWD2zbH6nL0V5VYIXkkmMUhu2U1nffsAvJZYrtNBlgamJExBlzO1dcjLZzu9kCHyNbCPauITUL4PyHpnA6VzqGS4BscHuvWICTIdLb2Hn8sWedDqOcRoBTRBOjrAjCFGGp7gj5lqKQqjMmDfNX2T5I4rJPA6Koxmsyf61sc84w-f92Vl8HagF03D40pyg9WNl4b1~UMF5DdSQp8TJlwdCwhULGpE7bqV1Q~HWine045yrMzf-bsEc7MZHv6hBFFAY5F07l5OqB2HeEh70rcDYqrJ62FtxBLfHdYSWbCzNXxS~ZrOo5AHgXRg6upBUbaeBrCORdTHmnZ~r1lEX-tebUnh4a1RN",
"state": "uploading",
"maxPartSize": 52418560,
"totalBytes": 33
}