List the Vault
q, it returns the best matches first instead. See Vault.
A key belongs to a person, so it works in the workspace that person is working in and sees what they see there: a guest’s key lists only the folders they were let into.
An unknown value is ignored rather than refused.
The response carries
total, limit, offset and next_offset, which is null on the last page. Each file in assets has:
Get one file
Publish a file’s CDN link
false) and returns the file with its cdn_url. A file’s CDN link is off until you turn it on, so a key may only do this when Let API keys publish CDN links is on in Account. Otherwise the call fails with 403 cdn_publishing_off. Publishing is sharing, so the key’s person also needs edit access to the file’s folder, and a guest never has it: otherwise the call fails with 403 not_allowed. A call that changes nothing always succeeds.
Each change is written to your activity with the key that made it.
Build a responsive image
A published image renders at these widths: 160, 320, 480, 640, 768, 1024, 1280, 1600, 2048, 2560 and 3200. Ask for any other width and you get the next one down. The CDN never upscales.cdn_srcset is this list for the file’s own width, without a format. Add &fmt=webp to each URL if you build it yourself.
Store a finished job
{"run_id": "…"} instead to store what a finished recipe run made. Add "folder": "Clients/Acme" to file them in a folder. A skill that answers in facts alone, like view-metadata, makes no file, and storing its job fails with 422 nothing_to_save.
To skip this step, send save_to_vault with the run itself. See Save results to the Vault.
A file whose bytes are already one of yours in this workspace isn’t stored twice. The answer is that file, with 200 and "existing": true. A new file is 201 with "existing": false.
Check for files already there
null. Upload only the nulls. Needs the read scope.
It checks what an upload would be matched against: files you added to the workspace the key works in. Files over 100 MB, and files stored before hashes were kept, have no hash and answer null. So does a file that has had a new version uploaded since.
List a file’s versions
mime_type, kind, width, height and duration_seconds. A file that was never replaced has one version. uploaded_by is a name only in a workspace with more than one person. Anyone who can view the file can read its history. A guest can only read it for files in their shared folders.
Upload a new version
409 job_not_finished, and one that failed with 409 job_failed. An upload that hasn’t landed yet fails with 409 upload_not_landed, and a facts-only job with 422 nothing_to_save. note is optional, up to 500 characters.
The file keeps its id, share link, CDN link, folder, tags and alt text. The old bytes stay as the previous version and still count against your storage. The new version has to be the same kind of file (image, video, audio or document), or the call fails with 422 wrong_kind. The key’s person needs edit access to the file’s folder, or the call fails with 403 not_allowed.
Returns 201 with asset_id, version, file_name, size_bytes and note. Deliveries already sent keep the version they were sent. The file’s CDN link serves the new version within an hour.
Poll a job
List galleries
Create a gallery
Embed a share link
GET https://mediamonster.app/api/oembed?url=<share link> is an oEmbed endpoint. It needs no key. See Integrations.
