28 September 2026
GET /api/v1/status?strict=trueanswers503when the status isdown, for monitors that only read status codes. Without it, nothing changes: always200. See Status.- status.mediamonster.app: incidents, maintenance and uptime history, hosted apart from Mediamonster, with updates you can subscribe to.
26 September 2026
The developer release. Everything below shipped together. Find your way in.- Quickstart. Test key, first call, dry run, a recipe by name, a webhook, then a live key — with curl, TypeScript, Python and MCP for each.
- API reference with a playground, built from the OpenAPI document. Paste a
mm_test_key and every call in it is free. - A page for every skill under Skill reference: what it takes and hands back, its price, every option, where it can sit in a recipe, and the call in six flavours. A page for every ready-made recipe under Recipe reference.
- SDKs and tools:
@mediamonster/sdkfor TypeScript,mediamonsterfor Python, themmCLI, and Postman and Bruno collections. - mediamonster.app/developers is a page of its own now, not a redirect here.
- Status.
GET /api/v1/statusand mediamonster.app/status: the API, database, storage, queue and encoders, checked live. /llms-full.txt: every live skill and recipe with its price, options and a request body, in one document for an agent.
- OpenAPI 3.1 at
GET /api/v1/openapi.json, one operation per skill (runBackgroundRemover,runCaptions, …) with its request as JSON Schema and its price underx-mediamonster. GET /api/v1/skills/{slug}: one skill, its request schema and an example body.- Recipes over the API.
GET /api/v1/recipesand/recipes/{ref}list the ready-made recipes, yours, and shared ones;POST /api/v1/runstakesrecipe— a slug, a saved recipe’s id or a public slug. - Copy as code on the Workbench, on every skill and recipe page, and on your saved recipes: what’s on screen, as the API call that does it.
- Sign in to MCP with OAuth. Add
https://mediamonster.app/api/mcpto Claude, ChatGPT, Cursor or VS Code and approve it in the browser; no key to paste. Connected apps are listed on the Keys page, with Disconnect. - Webhook endpoints: standing addresses with their own signing secrets, rotation with an overlap, test pings, and a 30-day delivery log with replay. See Webhooks.
- Key scopes, expiry and an address allow-list. See Authentication.
- Direct uploads for any file your plan takes, straight to storage. See Uploads.
- Usage per key: thirty days of requests, errors and credits, and a request log, at mediamonster.app/keys/usage.
- Test keys. Mint a
mm_test_…key on any plan, Cyclops included, beside your live keys — each plan holds as many of each. A test key goes through every check a live key does, then charges nothing, calls no model, and hands back a stand-in file of the right kind at once. Jobs and runs are real records you can poll, marked"test": true, and their webhooks are delivered. See Test mode. livemodeon every job and run, and on every webhook event:falsefor a test key’s.- Dry runs.
dry_run=trueonPOST /api/v1/run/{skill},/runsand/convertchecks everything, measures the file and answers with the price, step by step, and whether your balance covers it — without running or charging. See Dry runs. - Idempotency keys. Send
Idempotency-Keywith anyPOSTunder/api/v1and a retry gets the first answer back instead of running again. New codes:bad_idempotency_key,idempotency_key_reused,idempotency_in_progress,idempotency_unavailable. See Idempotency. - Rate-limit headers.
X-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Reseton every response to a call with a key,429s included. See Rate limits. - Request ids.
X-Request-Idon every response. Send your own and we keep it. - Errors that teach. Every error now carries
doc_url— its heading on Errors, which now explains every code with its cause and fix —request_id, andparamwhen one field is at fault. MCP errors carry the same indata. New code:test_mode_unsupported. - Versioning. v1 is additive-only; breaking changes wait for v2 and are announced six months ahead with
DeprecationandSunsetheaders. See Versioning. - Browsers can read
X-Request-Id, theX-RateLimit-*headers,Idempotent-Replayed,DeprecationandSunsetacross origins.

