Skip to main content
POST
Switch a file's CDN link on or off

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

Path Parameters

id
string<uuid>
required

The file's id.

Body

application/json
cdn
boolean
required

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.