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.
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.
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
ID of the video or audio asset to attach a custom thumbnail to.
^[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}$uuidRequest 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"}