Update live

put

https://api-v2.pandavideo.com.br/lives/{live_id}

Updates an existing live stream. All body fields are optional — only the fields you send will be changed. Returns the updated LiveItem.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

PUT /lives/`{live_id}`

Updates an existing live stream. All body fields are optional — only the fields included in the request will be changed. Returns the updated live object.

📘
Authorization
Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

HTTP Method & Path

PUT /lives/{live_id}

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

Field	Type	Required	Description	Constraints
`live_id`	string (uuid)	Yes	ID of the live stream to update.	uuid

Request Body

Content-Type: application/json

All fields are optional — only the fields included in the body will be updated.

Body Parameters

Field	Type	Required	Description	Constraints
`title`	string	No	Updated title of the live stream.	min 3 chars
`scheduled_at`	string	No	Updated scheduled start time (ISO 8601).	ISO 8601 (e.g. `2026-06-15T15:00:00Z`)
`bitrate`	array of strings	No	Updated set of video qualities for adaptive playback.	each item one of: `240p`, `360p`, `480p`, `720p`
`latency_type`	string	No	Updated latency profile of the live stream.	enum: `low` (5-7s), `default` (15-20s), `high` (60-70s)
`active_dvr`	boolean	No	Toggles DVR (allow viewers to rewind during the broadcast).	—
`folder_id`	string (uuid)	No	Folder where the recorded video will be stored after the live ends.	uuid
`status`	string	No	Override the live status. Typically used to cancel a scheduled live by sending `"canceled"`. Other values are usually managed automatically.	enum: `online`, `offline`, `canceled`, `finished`, `finished_imported`

{
  "title": "Updated live title",
  "scheduled_at": "2026-06-15T15:00:00Z",
  "latency_type": "low",
  "active_dvr": true
}

⚠️
Heads up: the field is scheduled_at (not scheduled_time). To cancel a scheduled live, send {"status": "canceled"}.

Response

Success Response (200)

Returns the updated live object:

{
  "id": "live-uuid",
  "title": "Updated live title",
  "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-15T15: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

Same shape as the Create live response. Key fields:

Field	Type	Description
`id`	string (uuid)	Unique identifier of the 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.
401 Unauthorized — Missing or invalid API token.
404 Not Found — Live not found for the given live_id.
500 Internal Server Error — Server-side error.

Example Usage

cURL — update title and schedule

curl -X PUT \
  'https://api-v2.pandavideo.com.br/lives/<live_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Updated live title",
  "scheduled_at": "2026-06-15T15:00:00Z"
}'

cURL — cancel a scheduled live

curl -X PUT \
  'https://api-v2.pandavideo.com.br/lives/<live_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "canceled"
}'

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

PUT /lives/{live_id}

Authorization

HTTP Method & Path

Authentication Requirements

Parameters

Path Parameters

Request Body

Body Parameters

Heads up: the field is scheduled_at (not scheduled_time). To cancel a scheduled live, send {"status": "canceled"}.

Response

Success Response (200)

Response Schema

Error Responses

Example Usage

cURL — update title and schedule

cURL — cancel a scheduled live

200200

400400

PUT /lives/`{live_id}`

Heads up: the field is `scheduled_at` (not `scheduled_time`). To cancel a scheduled live, send `{"status": "canceled"}`.