Skip to main content
POST
Open a direct upload

Authorizations

Authorization
string
header
required

Authorization: Bearer mm_live_…. Mint a key at mediamonster.app/keys; every plan includes the API. A test key, mm_test_…, runs every check a live key does and spends nothing: each run finishes at once with a stand-in file, and says livemode: false. A key does only what its scopes allow.

Headers

X-Request-Id
string

Your own id for this request — 8 to 128 letters, digits, ., _, : or -. Used in place of one we mint, and echoed back.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
Idempotency-Key
string

Retry this POST safely: the first request with a key runs and its answer is kept for a day; a retry with the same key and the same request gets that answer again, marked Idempotent-Replayed: true, instead of running twice. 1–255 printable characters — a UUID is a good one.

Required string length: 1 - 255

Body

application/json
file_name
string
required
size_bytes
integer
required

The file's exact size.

Required range: x >= 1
content_type
string

Response

Where to send the bytes.

upload_id
string<uuid>
method
any
url
string<uri>

One PUT, up to 100 MB.

headers
object
part_size
integer

Above 100 MB: the bytes in each part.

parts
object[]
size_bytes
integer
kind
enum<string>
Available options:
image,
video,
audio,
document
mime
string
expires_at
string<date-time>
complete_url
string