Removing a push target stops the restreamer from forwarding video to that RTMP destination. You identify the target to remove by its URL. The change takes effect immediately — the restreamer stops sending frames to that URL as soon as the request completes, with no interruption to the stream’s other targets.
Endpoint
DELETE /api/streams/{id}/targets
Path parameters
The name of the stream to remove a push target from.
Request body
The RTMP URL of the push target to remove. This must exactly match the url value stored for the target.
Example request
curl -X DELETE http://your-server:6070/api/streams/my-stream/targets \
-H "Content-Type: application/json" \
-d '{"target":"rtmp://a.rtmp.youtube.com/live2/YOUR_KEY"}'
curl -u user:pass -X DELETE http://your-server:6070/api/streams/my-stream/targets \
-H "Content-Type: application/json" \
-d '{"target":"rtmp://a.rtmp.youtube.com/live2/YOUR_KEY"}'
Response
Returns 200 OK with an empty body on success.
Error responses
| Status | Error value | Cause |
|---|
404 | stream not found | No stream with the given name exists. |
400 | HTTP status text | The request body was missing or the target URL was not found. |
