Skip to main content
POST
Finalize a streaming recording after all chunks have been uploaded. Bota queues background chunk stitching and returns the updated recording.

Authentication

This endpoint accepts either an API key or a device token.

Path Parameters

string
required
The streaming recording’s unique identifier.

Request Body

integer
required
Total number of chunks uploaded.
integer
Final recording duration in milliseconds.
integer
Final assembled file size in bytes.
string
Optional SHA-256 hash of the complete audio file as 64 lowercase hex characters. Bota verifies this after chunk stitching.
string
Optional base64-encoded bytes to append after all chunks before SHA-256 verification. This is used by encoders that write final container bytes only when the file closes.

Response

Returns the updated recording. The recording remains in a processing state while background stitching completes.

Chunk Upload URLs

Before finalizing, upload each chunk by requesting a per-chunk upload URL:
The chunk upload URL response is:

Webhooks

When stitching and verification complete, Bota emits the same recording and transcription events as normal uploads. If content_sha256 is supplied and verification fails, Bota emits recording.integrity_failure.