Add a destination to a stream
Adds one of your destinations (GET /destinations) to the stream, enabled; returns the stream’s destinations. Up to 5 per stream, one YouTube channel at most; a second destination needs multistream on the workspace (403 MULTISTREAM_NOT_ENABLED). Refused while the stream is live (409 STREAM_LIVE), and for a destination the stream’s quality cannot reach (422 DESTINATION_INCOMPATIBLE, with reason).
Authorizations
OAuth 2.1 authorization-code flow with PKCE.
- Authorization URL
- https://auth.streamloop.app/api/auth/oauth2/authorize
- Token URL
- https://auth.streamloop.app/api/auth/oauth2/token
Headers
Workspace this request operates in — the workspace id (wksp_…) or the organization id, from GET /workspaces. Required with an API key, which carries no workspace (400 WORKSPACE_REQUIRED without it). With an OAuth token it defaults to the workspace the token was issued for. Responds 403 WORKSPACE_FORBIDDEN when the caller is not a current member, rather than falling back to another workspace.
Optional client-generated key. A repeated request with the same key, method and path (by the same caller in the same workspace) replays the original response, with Idempotency-Replayed: true, for 24 hours instead of running again — safe retries. The same key with a different body is refused with 422 IDEMPOTENCY_KEY_REUSED (nothing runs): use a new key for each new request. A 5xx answer is not remembered (a retry runs).
Path Parameters
Resource identifier.