v1

latestOpenAPI 3.0.32026-07-22112930.0 KB

Streams

Create stream

Creates a live stream and returns a publish token. The current request body is empty. The retained frame history is fixed at 600 seconds.

The publish token is scoped to this stream and grants media publish permissions. Renew it through /keepalive before it expires.

post/streams

Headers

X-Overshoot-Region'us-west1' | 'us-central1'

Optional hint to route the request to the region that owns the stream. If the request reaches the wrong region the API returns 409 with a region_error body.

Response

Stream created.

idstring uuid required

Unique stream identifier. Use this in every subsequent stream URL.

state'active' required

Always active for a freshly created stream.

expires_at_msinteger required

Wall-clock Unix ms when the lease will expire if not renewed via /keepalive.

ttl_secondsinteger required

Lease TTL in seconds. Currently 300 for all streams.

Example response

{
  "ttl_seconds": 300
}