Live

HLS live streams, bursts and events.

📄️Register an HLS live stream

Register an HLS stream for SSAI ad-break monitoring. The service polls the manifest at `poll_interval_s` and creates a burst of scene analysis whenever a new ad boundary is detected.

📄️List live streams

List the HLS streams registered to your organization. Optionally filter by `namespace`.

📄️Get a live stream

Fetch one stream by its ID.

📄️Update a live stream

Partially update a stream's configuration or transition its status. Changing the `url` validates the new manifest synchronously — an unreachable or invalid playlist returns `422`.

📄️Delete a live stream

Remove a stream and stop monitoring it. **All associated bursts and scenes are permanently deleted** (cascade).

📄️Subscribe to stream events (NDJSON)

Long-lived NDJSON stream of real-time events for one stream. Each line is a JSON object with an `event` field:

📄️List bursts for a stream

List all ad-break bursts for a stream, newest first. Each burst includes its analyzed scenes. Filter with `since` (ISO 8601 datetime) to get only bursts created after a given point.

📄️Latest completed burst for a stream

Get the most recently completed burst for a stream. Returns `404` if no burst has completed yet.

📄️Get one burst (stream-scoped)

Fetch a specific burst within a stream. Returns `404` if the burst does not belong to this stream or does not exist.

📄️Latest bursts (global)

Get the most recently created bursts across all of your organization's streams. Filter with `since` (ISO 8601 datetime).

📄️Get one burst by ID

Fetch any burst by its ID, regardless of which stream produced it.