Live

Stop a live stream

End a running live stream on every platform, or cancel a scheduled one.

POST https://social-publish-api.onrender.com/v1/live/{id}/stop
  • Running (starting, live, ending): the stream stops within about 5 seconds. YouTube broadcasts are completed, Facebook live videos are ended, and Twitch goes offline. The final status is ended.
  • Scheduled: the stream is canceled (status: "canceled") and never starts.
curl -X POST https://social-publish-api.onrender.com/v1/live/c0ffee00-1234-4abc-9def-0123456789ab/stop \
  -H "x-access-key: $RELAYCAST_API_KEY"

The response is the stream (same shape as Get). A running stream may still show live right after the call; poll until it is ended.

Errors

StatusCodeWhen
404not_foundNo live stream with this ID in the project.
409not_runningThe stream has already ended, failed or been canceled.

This page is also available as Markdown.