Nurama Developers
Assets

Finalize the multipart upload of a custom thumbnail

Commits the multipart upload to S3/R2. The resulting ObjectCreated event triggers the post-processing pipeline (Cloudflare container, self-hosted media processor, or Lambda) which generates the sized `customThumbnail` outputs and reports them back via `/v1/assets/file-update`. No original-file side effects (does not register the original on the asset directly and does not invoke MediaConvert, unlike `/v1/assets/complete-upload`).

POST
/assets/{assetId}/custom-thumbnail/complete-upload

Commits the multipart upload to S3/R2. The resulting ObjectCreated event triggers the post-processing pipeline (Cloudflare container, self-hosted media processor, or Lambda) which generates the sized customThumbnail outputs and reports them back via /v1/assets/file-update. No original-file side effects (does not register the original on the asset directly and does not invoke MediaConvert, unlike /v1/assets/complete-upload).

Authorization

AuthorizationBearer <token>

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

Path Parameters

assetId*string
Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/assets/497f6eca-6276-4993-bfeb-53cbbbba6f08/custom-thumbnail/complete-upload" \  -H "Content-Type: application/json" \  -d '{    "key": "string",    "uploadId": "string",    "parts": [      {        "ETag": "string",        "PartNumber": 1      }    ]  }'
{  "status": "completed",  "key": "string"}