Skip to content
Braiv Docs

Activate professional hosting

Same action as Studio Activate Pro Hosting. Requires a Pro or Business plan and videos:write. Videos start on Standard hosting (hosting: standard). This endpoint moves them to Pro (hosting: pro).

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 Pro Hosting ingest was queued. 200 with status: ready or processing means it was already on Pro.

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 Pro Hosting and a source file is ready. 422 means the plan does not include Pro Hosting, or the source has no url / videoOnlyUrl.

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