Cancel live

POST 
/bv/cms/v1/lives/:id:cancel

Terminates the live stream. Once canceled, the live stream will be archived.

---

Prerequisites: This API can be invoked when the live status is one of the following:

• LIVE_STATUS_SCHEDULED
• LIVE_STATUS_WAIT_FOR_PREVIEW
• LIVE_STATUS_PREVIEW
• LIVE_STATUS_LIVE
• LIVE_STATUS_VOD_READY
• LIVE_STATUS_VOD

---

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

Request

Responses

200

A successful response.

400

A bad request response. The code is 3 means got an invalid argument. There are more HTTP status code mappings listed on here and gRPC code on here.

401

A unauthenticated response. The header authorization was missing or unidentified.

403

A forbidden response. It means that the provided authorization did not have enough permission to access the resource or the API.

500

A server error response. There are more HTTP status code mappings listed on here.

default

An unexpected error response.