Skip to main content
POST
Create a gallery

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
title
string
required
Maximum string length: 120
asset_ids
string<uuid>[]
Maximum array length: 500

Response

The gallery.

id
string<uuid>
title
string
slug
string
visibility
string
item_count
integer
downloads
any
expires_at
string<date-time> | null
view_count
integer
url
string<uri> | null
created_at
string<date-time>
added
integer