Resolve a public asset link to embed-player file paths
Returns the HLS streaming manifest keyPath and a fallback original-media keyPath for the asset behind a public download token. This is what the embeddable player at `/public/{token}/embed` uses. Resolve keyPaths against the base media URL. Play the `.m3u8` manifest with an HLS-capable player when `streamKeyPath` is present, falling back to the original media file otherwise. Only `video` and `audio` assets are meant to be embedded; the response still returns paths for other media types, but they should not be embedded. No authentication required. Returns minimal file info — never the full asset record (no `id`, `files`, `creatorId`, etc.).
Returns the HLS streaming manifest keyPath and a fallback original-media keyPath
for the asset behind a public download token. This is what the embeddable
player at /public/{token}/embed uses.
Resolve keyPaths against the base media URL. Play the .m3u8 manifest with an
HLS-capable player when streamKeyPath is present, falling back to the original
media file otherwise. Only video and audio assets are meant to be embedded;
the response still returns paths for other media types, but they should not be
embedded.
No authentication required. Returns minimal file info — never the full asset
record (no id, files, creatorId, etc.).
Path Parameters
The 10-character alphanumeric public download token.
^[a-zA-Z0-9]+$10 <= length <= 10Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/public-download/Ab3dEf9HiJ/embed-files"{ "fileName": "my-video.mp4", "mediaType": "video", "mode": "embed-download", "streamKeyPath": "/workspaces/abc/assets/123/stream/index.m3u8", "mediaKeyPath": "/workspaces/abc/assets/123/media/my-video.mp4", "posterKeyPath": "/workspaces/abc/assets/123/customThumbnail/large.jpg?v=019e10aa-0000-7000-8000-000000000002", "waveformKeyPath": "/workspaces/abc/assets/123/waveform/peaks.json"}