Complete multipart upload
Complete a multipart upload for an asset file to S3. This endpoint finalizes the S3 multipart upload by combining all uploaded parts, registers the original file on the asset (`assetId` is required) and triggers asset completion and media post-processing. **Two-step workflow:** 1. Upload file parts to S3 using signed URLs 2. Call this endpoint with `assetId` to complete upload and trigger processing Post-processing failures after the S3 upload has been committed do not fail the request — they are reported via the optional `warning` field. Only the asset's creator — the user who started the upload — may complete it. An asset whose original has been pruned or is being re-attached is refused with 409: its original comes back only through re-attach, which verifies it.
Complete a multipart upload for an asset file to S3.
This endpoint finalizes the S3 multipart upload by combining all uploaded parts,
registers the original file on the asset (assetId is required) and triggers
asset completion and media post-processing.
Two-step workflow:
- Upload file parts to S3 using signed URLs
- Call this endpoint with
assetIdto complete upload and trigger processing
Post-processing failures after the S3 upload has been committed do not fail the
request — they are reported via the optional warning field.
Only the asset's creator — the user who started the upload — may complete it. An asset whose original has been pruned or is being re-attached is refused with 409: its original comes back only through re-attach, which verifies it.
OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.
In: header
Scope: assets:write
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/assets/complete-upload" \ -H "Content-Type: application/json" \ -d '{ "key": "string", "uploadId": "string", "parts": [ { "ETag": "string", "PartNumber": 0 } ], "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8" }'{ "status": "completed", "warning": "Post-processing failed"}