Deleting a stream removes it and all of its associated push targets from the server’s configuration. The RTMP ingest URL for that stream stops accepting connections as soon as the request completes. If the stream name does not exist, the server returns a 404.
This action is permanent. Deleting a stream cannot be undone. All push targets configured for the stream are also deleted. Any encoder currently streaming to the RTMP ingest URL will be disconnected.

Endpoint

DELETE /api/streams/{id}

Path parameters

id
string
required
The name of the stream to delete.

Example request

curl -X DELETE http://your-server:6070/api/streams/my-stream
With authentication enabled:
curl -u user:pass -X DELETE http://your-server:6070/api/streams/my-stream

Response

Returns 200 OK with an empty body on success.

Error responses

StatusError valueCause
404stream not foundNo stream with the given name exists.