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.