Starts a scheduled live ahead of its scheduled time. The live must be offline, and the 200 only means the start was accepted, not that the live is already on air.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
POST /lives/{live_id}/start
{live_id}/startStarts a scheduled live ahead of its scheduled time. The live must be offline; starting it clears scheduled_at, so the live stops being scheduled and becomes available for the encoder right away.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
200does not mean the live is already on air. The response only confirms the start was accepted. The live moves toonlinewhen the ingest channel reports it is running and your encoder is publishing. Poll Get live and watchstatusinstead of assuming the transition.
Trial accounts cannot start lives. The call returns400 live is not available for trial accounts.
HTTP Method & Path
POST /lives/{live_id}/start
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
| Security Scheme | Header | Note |
|---|---|---|
| API Key | Authorization | Panda API token (without Bearer prefix) |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
live_id | string (uuid) | Yes | ID of the live to start. Must be a valid uuid, otherwise the call returns 400. |
This endpoint takes no body.
Response
Success Response (200)
{ "status": true }| Field | Type | Description |
|---|---|---|
status | boolean | true when the start was accepted for processing. |
Error Responses
400 Bad Request
{ "errCode": "BadRequest", "errMsg": "live already started" }| Message | When |
|---|---|
live already started | The live is not in offline status — or it is offline but was never scheduled, so there is nothing to bring forward. |
live is not available for trial accounts | The account is on trialing. |
invalid live id: "{value}" | The live_id in the path is not a valid uuid. |
404 Not Found — { "errCode": "NotFound", "errMsg": "Live with id: {live_id} was not found" }, when the live does not exist or belongs to another account.
500 Internal Server Error — the subscription status of the account could not be read, or the ingest channel failed to start.
Example Usage
cURL
curl -X POST "https://api-v2.pandavideo.com.br/lives/{live_id}/start" \
-H "Authorization: {api_key}"Related
- Create live —
scheduled_atsets the time this endpoint brings forward. - Get live — poll
statusafter starting. - Get ingest signal info — confirm the encoder signal is arriving.
- Finish live — end the broadcast.