post
https://api-v2.pandavideo.com.br/lives/
Creates a new live stream (Live V2/IVS) and returns the ingest endpoints (RTMP/IVS), the HLS player, and the IDs required to start broadcasting from an encoder.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
POST /lives
Creates a new live stream (Live V2 / IVS) and returns the live object with the ingest endpoints (RTMP/IVS), the HLS player URL, and the IDs required to start broadcasting from an encoder (OBS, etc.).
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
POST /lives
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) |
Request Body
Content-Type: application/json
Body Parameters
| Field | Type | Required | Description | Constraints |
|---|---|---|---|---|
title | string | Yes | Default title of the live stream — shown in the live preview and used as the name of the recorded video stored in the Panda platform. | min 3 chars |
stream_key_id | string (uuid) | No | ID of the stream key to attach to this live. Retrieve available keys with GET /live_stream_key. If omitted, the account's default key is used. | uuid |
scheduled_at | string | No | Schedules the live for a specific date and time (ISO 8601). | ISO 8601 (e.g. 2026-06-01T15:00:00Z) |
bitrate | array of strings | No | Video qualities to enable, for adaptive playback depending on the viewer's connection. | each item one of: 240p, 360p, 480p, 720p |
latency_type | string | No | Latency profile of the live stream. | enum: low (5–7s), default (15–20s), high (60–70s) |
active_dvr | boolean | No | Enables DVR functionality so viewers can rewind during the broadcast. When disabled, the stream stays strictly in real-time. | — |
folder_id | string (uuid) | No | Folder where the recorded video will be stored once the live ends. Useful for organization inside the Panda platform. | uuid |
{
"title": "My live stream",
"stream_key_id": "11111111-2222-3333-4444-555555555555",
"scheduled_at": "2026-06-01T15:00:00Z",
"bitrate": ["360p", "720p"],
"latency_type": "low",
"active_dvr": true,
"folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
Heads up: the field isscheduled_at(notscheduled_time) and the stream key reference isstream_key_id(the ID, not the key value).latency_typeis a single string from the enum, not an array.
Response
Success Response (200)
Returns the created live object:
{
"id": "live-uuid",
"title": "My live stream",
"status": "offline",
"stream_key_id": "11111111-2222-3333-4444-555555555555",
"stream_key": "sk_live_xxxxx",
"rtmp": "rtmps://...ivs.us-east-1.amazonaws.com/app/",
"live_hls": "https://.../live.m3u8",
"live_player": "https://player.pandavideo.com.br/embed/?v=live-uuid",
"scheduled_at": "2026-06-01T15:00:00Z",
"started_at": null,
"ended_at": null,
"vod_id": null,
"bitrate": ["360p", "720p"],
"active_dvr": true,
"latency_type": "low",
"folder_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"ivs_ingest_endpoint": "rtmps://...ivs.amazonaws.com:443/app/",
"ivs_playback_url": "https://...playback...",
"relay_ingest_endpoint": "rtmp://relay.pandavideo.com.br/...",
"created_at": "2026-05-28T00:00:00.000Z"
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Unique identifier of the created live. |
title | string | Title of the live stream. |
status | string | Current status. Enum: offline, online, canceled, finished, finished_imported. |
stream_key_id | string (uuid) | Stream key attached to this live. |
stream_key | string | Stream key value used by the encoder (OBS) in the RTMP URL. |
rtmp | string | Primary RTMP/RTMPS ingest endpoint. |
live_hls | string | HLS playback URL. |
live_player | string | Embeddable player URL for the live. |
scheduled_at | string | null | Scheduled start (ISO 8601), if any. |
started_at | string | null | Actual start timestamp (set when the stream begins). |
ended_at | string | null | End timestamp. |
vod_id | string | null | ID of the recorded VOD generated after the live ends. |
bitrate | array of strings | Enabled video qualities. |
active_dvr | boolean | Whether DVR is enabled. |
latency_type | string | Latency profile (low / default / high). |
folder_id | string (uuid) | null | Destination folder for the VOD. |
ivs_ingest_endpoint | string | IVS ingest endpoint. |
ivs_playback_url | string | IVS playback URL. |
relay_ingest_endpoint | string | Relay RTMP ingest endpoint (fallback/restream). |
created_at | string | ISO 8601 creation timestamp. |
Error Responses
- 400 Bad Request — Invalid body or missing required fields (e.g.,
titleshorter than 3 chars). - 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Provided
stream_key_iddoes not exist or does not belong to the authenticated user. - 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X POST \
'https://api-v2.pandavideo.com.br/lives' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{
"title": "My live stream",
"stream_key_id": "11111111-2222-3333-4444-555555555555",
"scheduled_at": "2026-06-01T15:00:00Z",
"bitrate": ["360p", "720p"],
"latency_type": "low",
"active_dvr": true
}'