Get an archived-stream thumbnail

GET 
/program/api/v2/archive/thumbnail

Seeks into an archived HLS stream at the given timestamp and returns a single encoded image (jpg/png/webp). The program service looks up the project's archiving-config (including the public playback base URL) in vault and delegates the actual frame extraction and encoding to the foundation-mediaassets service. When the timestamp falls in a gap between archive sessions, the closest session by time is used; ties prefer the session before.

Generate JWT

Request

Responses

• 200
• 400
• 403
• 404
• 500

Encoded thumbnail image. Content type depends on the response query param — image/{jpeg,png,webp} for body, application/json (ArchiveAssetMetadata) for metadata.

Bad request (invalid params, fileType not HLS)

Forbidden - No project access

Archiving config not found, or no archive sessions for the stream key

Internal Server Error