Requires the API entitlement (Pro+). Interactive reference under the API Reference tab.

Base URLs

https://api.modkrib.com/api/v1        # session-auth surface
https://api.modkrib.com/api/v1/v1     # public API (api-key auth)

Authentication

Mint a key in Settings → Developer → API keys (shown once). Send it as a bearer token:
curl https://api.modkrib.com/api/v1/v1/whoami \
  -H "Authorization: Bearer mb_live_xxx"
Keys are scoped (read, jobs:create, …) and rate-limited per plan.

Errors

Errors return { "detail": "<message>" }. Codes: 401 unauth · 403 forbidden/entitlement · 404 missing · 429 rate-limited · 400 validation. Long jobs return 202 + a job_id.

Recipe — transcribe → burn → publish

1

Upload

POST /assetsasset_id
2

Transcribe

POST /assets/{asset_id}/transcribe → subtitle asset
3

Burn

POST /assets/{asset_id}/burn {subtitle_asset_id}
4

Schedule

POST /assets/{video_id}/schedule {platforms, caption, when}

SDKs

  • TypeScript @mediabliss/sdk — typed client, retries, job awaiter, verifyWebhook.
  • Python mediabliss — client, verify_webhook, Job.
See Webhooks for signature verification.