Docs › Uploading while recording
Uploading while recording (advanced)
For live recordings, upload while the recording is still being made, so the result is ready moments after it stops:
- Create with
"streaming": true(nosizeBytes). Add"prestart": trueto have processing ready and waiting. It waits up to 5 minutes; for longer recordings it stands down and starts normally when you complete (about 30–60 seconds later). - Request each part's URL with its exact size:
{"parts": [{"partNumber": 4, "sizeBytes": 8388608}]}. Every part except the last must be at least 5 MiB. - With
prestart, sendPOST /videos/{id}/heartbeatevery ~10 seconds while recording. If heartbeats stop for 2 minutes, the waiting job gives up. - When recording ends, call
completewith the totals:{"source": {"sizeBytes": …, "partCount": …}}. To cancel instead, callabort.