Skip to main content
GET
One Vault file

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

Path Parameters

id
string<uuid>
required

The file's id.

Response

The file.

A Vault file. thumbnail_url is signed and short-lived unless the file's CDN link is on — don't store it.

id
string<uuid>
file_name
string
title
string | null
alt_text
string | null
kind
string
mime_type
string
size_bytes
integer
width
integer
height
integer
duration_seconds
number | null
folder
string | null
tags
string[]
source
string
created_at
string<date-time>
share_url
string<uri> | null
cdn_enabled
boolean
cdn_url
string<uri> | null
cdn_srcset
string | null
thumbnail_url
string<uri> | null
match
object | null

Only on a search: where the file matched, and the words around it.