Media library
Browse and inspect files managed in Insight's media library. Paths are relative to the top of the library; destructive operations reject traversal and clear source assignments that would otherwise reference deleted media.
List media files as a folder tree
Returns the complete visible media-library hierarchy using relative paths that can be passed directly to inspection, assignment, preview, and deletion APIs. Hidden entries and macOS archive metadata are omitted so the result matches what users see in Insight. File nodes carry `streamable`, folder nodes carry `streamable_count`, so clients hide unsupported files with the server's rule.
Delete a media file or directory
Permanently deletes a file or directory inside the media library. If a deleted file (or any file inside a deleted directory) is assigned to a media-source slot, Insight stops that slot and clears the assignment, and it discards any cached FPS renditions built from the deleted files. Prefer stopping active sources first, and always obtain the relative path from the media tree rather than sending an absolute host path.
Inspect a media file
Probes one media-library file and returns normalized metadata suitable for deciding how it can be previewed or streamed. Images report dimensions, mode, and format; videos report track codec, normalized codec, duration, frame rate, and dimensions when available.
Stream an MJPEG preview for a media file
Transcodes or relays a media-library file as a long-lived multipart MJPEG response for lightweight browser preview. This is a preview transport rather than a downloadable file; clients must handle an open-ended stream and close it when the preview is no longer visible.
Download or preview a media file
Serves the original bytes for a relative path inside the media library using the detected content type. Browsers may display supported media inline; automation can use the same route to download the file. Missing paths return `404` and traversal outside the library is not permitted.