Live

Relaunch a live stream

Start a new live stream now with the same source, settings and destinations as an earlier one.

POST https://social-publish-api.onrender.com/v1/live/{id}/relaunch

Creates a new stream (new ID) that starts now, copying the title, description, source, loop, video mode, time limit and destinations, including custom stream keys. The original stream is unchanged.

Some platforms issue single-use stream keys (Instagram, for example). Relaunching with an old key fails for that destination. Create a new stream with a fresh key instead.

curl -X POST https://social-publish-api.onrender.com/v1/live/c0ffee00-1234-4abc-9def-0123456789ab/relaunch \
  -H "x-access-key: $RELAYCAST_API_KEY"

Returns 201 with the new stream. The same checks and errors as Create a live stream apply. For example, an account that has since been disconnected returns account_inactive, and a deleted source video returns unknown_media.

This page is also available as Markdown.