PApandavideo

Create live

Creates a live stream. Returns the ingest endpoint for your encoder, the playback URLs and the live status. A live is created as provisioning; region, quality_package and save_vod are set here and cannot be changed later.

post/

Request

  • Base URL
    https://api-v2.pandavideo.com.br/lives
  • URL
    https://api-v2.pandavideo.com.br/lives/
  • Auth
    API key in header Authorization

Request body

titlestring required

Default title of the live stream - shown in the live preview and used as the name of the recorded video.

stream_key_idstring uuid

ID of the stream key to attach to this live. Retrieve available keys with GET /live_stream_key.

scheduled_atstring

Schedules the live for a specific date and time, with no timezone suffix. A trailing Z is rejected with 400. Limited to 30 days ahead.

bitratestring[]

Video qualities to enable for adaptive playback. Values above 720p are accepted and silently reduced to 720p.

latency_type'low' | 'default' | 'high'

Latency profile of the live stream. low (5-7s), default (15-20s), high (60-70s).

active_dvrboolean

Enables DVR so viewers can rewind during the broadcast.

folder_idstring uuid

Folder where the recorded video will be stored after the live ends.

region'us' | 'br'

Where the stream is ingested: us or br. Defaults to us. This is where your encoder publishes, not your viewers region. It also affects the per-minute rate. If the stream key has a fixed region, that wins.

quality_package'sd' | 'hd' | 'fhd' | '4k'

Sets the whole quality ladder at once: sd, hd, fhd, 4k. Overrides bitrate when both are sent. Maximum delivered quality is currently 720p.

save_vodboolean

Record the live as a video when it ends. With false no recording is produced and it cannot be recovered later.

stream_keystring uuid

The stream key value, as an alternative to stream_key_id.

Example request

{
  "title": "My live stream",
  "stream_key_id": "11111111-2222-3333-4444-555555555555",
  "scheduled_at": "2026-09-20T14:30:00",
  "bitrate": [
    "360p",
    "720p"
  ],
  "latency_type": "low",
  "active_dvr": true,
  "region": "us",
  "quality_package": "hd",
  "save_vod": true,
  "stream_key": "f58b18a0-9eea-4cf8-bcb6-b4b8d6cd9a80"
}

Response

200

idstring
titlestring
rtmpstring

Ingest server without the key. Prefer ingest_endpoint.

stream_key_idstring
stream_keystring

Stream key value used by the encoder.

user_idstring
started_atunknown
ended_atunknown
vod_idunknown
status'provisioning' | 'offline' | 'online' | 'finishing' | 'finished' | 'finished_imported' | 'expired' | 'canceled'

Current status of the live. A live is created as provisioning.

live_playerstring

Embeddable player URL for the live.

live_hlsstring

Legacy playback URL. Prefer playback_url.

bitrateobject[]
folder_idunknown
active_dvrboolean
scheduled_atunknown
created_atstring
gcore_pullzone_idunknown
gcore_pullzone_statusunknown
latency_typestring
ingest_endpointstring

Full RTMP publish URL, stream key included. This is what goes into your encoder.

ingest_hostnamestring

Ingest server only, without the key. Specific to your account.

playback_urlstring nullable

Playback URL for the live. Null until the live is ready.

region'us' | 'br'

Ingest region of this live: us or br.

quality_packagestring

Quality ladder applied to this live.

save_vodboolean

Whether this live is being recorded.

video_idstring nullable

Video created from the recording, once ready.

view_metricsobject

Audience metrics of the live.

configobject

Settings of the live.

chat_idstring nullable

Chat of the live.

chat_statusstring nullable

Status of the live chat.

current_timestring

Server time when the response was produced.

Example response

{
  "id": "X",
  "title": "X",
  "rtmp": "rtmp://vz-{hash}.us.pandavideo.live/live",
  "stream_key_id": "X",
  "stream_key": "f58b18a0-9eea-4cf8-bcb6-b4b8d6cd9a80",
  "user_id": "X",
  "status": "provisioning",
  "live_player": "https://player-vz-{hash}.tv.pandavideo.com.br/embed/live/?v={live_id}",
  "live_hls": "https://b-vz-{hash}.tv.pandavideo.com.br/{live_id}/playlist.m3u8.live",
  "active_dvr": true,
  "created_at": "X",
  "latency_type": "X",
  "ingest_endpoint": "rtmp://vz-{hash}.us.pandavideo.live/live/{stream_key}",
  "ingest_hostname": "vz-{hash}.us.pandavideo.live",
  "region": "us",
  "quality_package": "hd",
  "save_vod": true,
  "current_time": "2026-09-07T02:41:51.204Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.