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/BadRequesterror withERROR_REASON_ACTION_NOT_ALLOWEDif the live status is in an impermissible state for cancellation. - Return a
404/NotFounderror if the requested live stream is not found.
Request
Responses
- 200
- 400
- 401
- 403
- 500
- default
A successful response.
A unauthenticated response.
The header authorization was missing or unidentified.
A forbidden response.
It means that the provided authorization did not have enough permission to access the resource or the API.
A server error response. There are more HTTP status code mappings listed on here.
An unexpected error response.