index/functions/getRecordingThumbnailUrl.md

getRecordingThumbnailUrl(tokenName, recordingId, baseUrl, extension?): string

Get redirect URL for a recording thumbnail

Static thumbnail image extracted from a recording's first frame or keyframe.

Backend: Redirects to Mux thumbnail if available, otherwise placeholder.

Parameters

Parameter	Type	Description
tokenName	string	Token name (lowercase)
recordingId	string	Recording asset ID (from Mux)
baseUrl	string	API base URL
extension?	string	File extension (optional, default: 'jpg')

Returns

string

Full redirect URL to recording thumbnail

Throws

Error if token name or recording ID is invalid

Example

const thumbUrl = getRecordingThumbnailUrl(
  'anime',
  'asset_abc123',
  'https://api.example.com',
  'png'
);
// → "https://api.example.com/v1/tokens/anime/recordings/asset_abc123/assets/thumbnail.png"

Since

7.3.0