Create stream
Changed onCreates 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.
Request
- Base URLhttps://api.overshoot.ai/v1beta
- AuthHTTP bearer
Headers
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.
Request body
Example request
{
"source": {
"url": "rtsp://user:pass@camera.example.com:554/stream"
}
}Response
Stream created.
Example response
{
"ttl_seconds": 300
}Changes
- breaking
the response property
became nullable for the status - breaking
the
response's property type changed fromobjectto no type for status - breaking
removed the required property
/from the response with the status - breaking
removed the required property
/from the response with the status - breaking
removed the required property
/from the response with the status - info
added optional request body
- info
added the non-success response with the status
- info
added the optional property
to the response with the status - info
added to the
response propertyallOflist for the response status
- breaking