Skip to content
Developer Preview

media/upload

Moves one video chunk into the session’s video store; answers the uploadId receipt on every chunk.

Type: MediaUploadParams

media/upload params: one chunk of a client-minted upload. All members required.

Field Type Stability Presence Description
chunkBase64 string required This chunk’s bytes; each call’s frame stays in the budget.
chunkCount integer required The upload’s chunk total; positive.
chunkIndex integer required This chunk’s 0-based position.
commandId string required One per call. While the host runs, replaying it with the same params returns the recorded receipt, and reusing it with different params is refused. After a host restart, start over under a new uploadId.
mediaType string required video/mp4 or video/quicktime, matching VideoInput.
sessionId string required The session owning the video store.
totalBytes integer required The assembled byte count; must equal the bytes the chunks deliver.
uploadId string required The client-minted upload id (UUIDv7), sent on every chunk.
Source

schema/msp/experimental/msp.schema.json#/methods/media~2Fupload

{
"description": "Moves one video chunk into the session's video store; answers the `uploadId` receipt on every chunk.",
"params": {
"$ref": "#/$defs/MediaUploadParams"
},
"result": {
"$ref": "#/$defs/MediaUploadResult"
}
}