Skip to main content
POST
Create an upload

Authorizations

Authorization
string
header
required

An API key: Authorization: Bearer mbk_live_...

Body

application/json
file_name
string
required

Shown as the transcript's title.

Maximum string length: 255
content_type
enum<string>
required

MP3, M4A, AAC, WAV, FLAC, OGG, Opus or WebM audio, or MP4, MOV, MKV or WebM video (only the sound is kept).

Available options:
audio/mpeg,
audio/mp4,
audio/x-m4a,
audio/aac,
audio/wav,
audio/x-wav,
audio/wave,
audio/vnd.wave,
audio/flac,
audio/x-flac,
audio/ogg,
audio/opus,
audio/webm,
video/mp4,
video/quicktime,
video/x-matroska,
video/webm
byte_size
integer
required
Required range: 1 <= x <= 2147483648

Response

Upload created

id
string<uuid>
object
string
Allowed value: "upload"
upload_url
string<uri>

PUT the file bytes here, with the returned headers.

headers
object
file_name
string
content_type
string
byte_size
integer
status
string
Allowed value: "pending"
Last modified on October 26, 2026