Nurama Developers
Assets

Mint a signed multipart upload URL for a custom thumbnail

Returns a multipart upload URL set for a user-supplied custom thumbnail image. The upload lands in the originals bucket under `<assetPath>/custom-thumb/<assetId>.<ext>` tagged so the post-processing Lambda / Cloudflare container / self-hosted media processor generates the sized `customThumbnail` outputs and registers them on the asset via the file-update callback. Side effect: any prior active `customThumbnailOriginal` / `customThumbnail` files on the asset are flipped to `inactive` before the URL is issued so the new run replaces cleanly. If the user abandons the upload, the asset falls back to its auto-generated thumbnail via `getDisplayThumbnail` on the frontend. Custom thumbnails are only supported for `video` and `audio` assets.

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

Returns a multipart upload URL set for a user-supplied custom thumbnail image. The upload lands in the originals bucket under <assetPath>/custom-thumb/<assetId>.<ext> tagged so the post-processing Lambda / Cloudflare container / self-hosted media processor generates the sized customThumbnail outputs and registers them on the asset via the file-update callback.

Side effect: any prior active customThumbnailOriginal / customThumbnail files on the asset are flipped to inactive before the URL is issued so the new run replaces cleanly. If the user abandons the upload, the asset falls back to its auto-generated thumbnail via getDisplayThumbnail on the frontend.

Custom thumbnails are only supported for video and audio assets.

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

ID of the video or audio asset to attach a custom thumbnail to.

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/upload-url" \  -H "Content-Type: application/json" \  -d '{    "fileName": "cover.jpg",    "mimeType": "image/jpeg",    "sizeInMB": 1.2  }'
{  "fileName": "string",  "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8",  "uploadId": "string",  "key": "string",  "urls": [    "string"  ],  "mimeType": "string",  "expires": 0,  "status": "success"}