Skip to main content

Preview live

POST 

/bv/cms/v1/lives/:id:preview

Initiates the live streaming preview. The live stream becomes viewable in the control room when its status transitions to LIVE_STATUS_PREVIEW. However, it remains inaccessible to the audience.


Prerequisites: This API can be invoked when the live status is LIVE_STATUS_WAIT_FOR_PREVIEW.


  • Return a 400/BadRequest error with ERROR_REASON_ACTION_NOT_ALLOWED if the live status is not in a permissible state for preview.
  • Return a 404/NotFound error if the requested live stream is not found.

Request

Path Parameters

    id stringrequired

    Required. The unique id of the live.

Header Parameters

    x-bv-org-id stringrequired

    To invoke this API using api_token, you need to set the x-bv-org-id header to specify the organization for which you want to perform the action.

Body

required

    object

Responses

A successful response.

Schema

    object

Loading...