---
title: "Activate professional hosting"
method: POST
path: "/videos/{videoId}/professional-hosting"
tags: ["Hosting"]
---

# Activate professional hosting

`POST /videos/{videoId}/professional-hosting`

## Request

- Base URL: `https://api.braiv.co/v1`
- URL: `https://api.braiv.co/v1/videos/{videoId}/professional-hosting`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Activates Pro Hosting on the current source, the same as Studio
Activate Pro Hosting. Idempotent when Pro Hosting is already live or
processing. Required scope: `videos:write`. Requires a Pro or Business
plan. Empty JSON body is valid.

## Path parameters

- `videoId` string, required

## Headers

- `Idempotency-Key` string

## Request body

- ActivateProfessionalHostingRequest: Empty object. Idempotency-Key is optional.

## Response `200`

Already on Pro Hosting or Pro ingest is in progress.

- ProfessionalHosting
  - `videoId` string, required: Library video id.
  - `status` 'inactive' | 'queued' | 'processing' | 'ready', required: inactive is Standard hosting. queued and processing are Pro Hosting ingest. ready is live Pro playback.
  - `canActivate` boolean, required: True when the plan allows Pro Hosting and a source file is ready.
  - `hosting` 'standard' | 'pro', required: Current playback hosting. standard is default ingest. pro is Pro Hosting.
  - `reason` 'plan_required' | 'missing_input': Why canActivate is false when status is inactive.

## Other responses

- `202`: Pro Hosting ingest queued.
- `401`: A supported authentication header is missing or contains an invalid Public API key.
- `403`: Authentication succeeded, but the required scope, workspace role, or resource permission is missing.
- `404`: The resource does not exist or is not accessible to the caller.
- `422`: Request fields are missing, malformed, out of bounds, or mutually inconsistent.
- `429`: The API key exceeded its allowed concurrency or request rate. Retry after in-flight work completes or the limit resets.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/braiv/apis/braiv-public-api.md) - [All operations](https://skmtc.dev/braiv/apis/braiv-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/braiv/apis/braiv-public-api/revisions/8ed0fd0d0a6f?raw)