Start moderating a live stream
POST/v3/streams
Start moderating a live HLS stream. Every segment with a violation is reported to callback_url while the stream is live; moderation ends when the stream ends. The source is checked before the stream starts: its playlist and newest segment must be readable within 3s. A live playlist with no segments yet is accepted; an ended one is not.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 503
A stream with this external_stream_id is already running with the same source, callback and callback key. status is already_running and nothing new is started
Stream accepted for moderation. status is starting
Bad request - validation failed, including an unknown field, a URL that is not https or does not resolve to a public address, or a callback_key_name the project has not defined
Unauthorized - invalid or missing authentication credentials
Forbidden - this API serves content moderation projects only
Conflict - a stream with this external_stream_id is already running with a different source, callback or callback key. Nothing is started; wait for it to end or use a new id
Unprocessable - the source could not be read and nothing is started. The body's reason is one of playlist_unreachable, not_hls, unsupported_format, rendition_unreachable, segment_unreachable, no_segments or timeout
Rate limit exceeded - too many requests
Service unavailable - the stream could not be started, retry the request