Skip to main content
GET
What's in your Vault

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}$

Query Parameters

folder
string
tag
string
q
string
kind
enum<string>
Available options:
image,
video,
audio,
document
source
enum<string>
Available options:
upload,
workbench,
api,
automation
shared
boolean
limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
Required range: x >= 0
page
integer
Required range: x >= 1
per_page
integer
Required range: 1 <= x <= 200

Response

A page of files, and how much room is left.

storage
object
total
integer
limit
integer
offset
integer
next_offset
integer | null
assets
object[]