Start a stream.
Start a stream.
Move the stream into Activating via streamlifecycle.Transition(_, CmdStart).
Returns the loaded stream after the lifecycle owner accepted the command. The
resolver does not block on the orchestrator/agent observing the change.
Typed errors (extensions.code):
- STREAM_ILLEGAL_TRANSITION when the current state forbids start
- STREAM_GUARD_FAILED when a pre-flight guard rejected start
(Extensions carries
reason+cause).
POST
Start a stream.
Authorizations
OAuth 2.1 authorization-code flow with PKCE.
Headers
Optional client-generated key. A repeated request with the same key replays the original response (within 24h) instead of re-executing — safe retries.
Path Parameters
Resource identifier.
Response
Successful response.
Available options:
f_24, f_25, f_30, f_60 Available options:
q_720p, q_1080p, q_1440p, q_2160p Available options:
draft, invalid, scheduled, preparing, activating, active, failing, failed, stopping, stopped