Skip to content
Braiv Docs

Activate professional hosting

Same action as Studio Activate Pro Hosting. Requires a Pro or Business plan and videos:write.

Terminal window
curl -sS -X POST "$BRAIV_API_BASE/videos/$VIDEO_ID/professional-hosting" \
  -H "Authorization: Bearer $BRAIV_API_KEY" -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'

202 means Mux ingest was queued. 200 with status: ready or processing means it was already on Mux.

Poll until ready:

Terminal window
curl -sS "$BRAIV_API_BASE/videos/$VIDEO_ID/professional-hosting" \
  -H "Authorization: Bearer $BRAIV_API_KEY"

canActivate is true only when the plan allows Mux and a source file is ready. 422 means the plan does not include professional hosting, or the source has no url / videoOnlyUrl.

From MCP: braiv_activate_professional_hosting, then braiv_get_professional_hosting until status is ready.