put
https://api-v2.pandavideo.com.br/live_stream_key/
Updates the display name and/or regenerates the stream key value for a live stream key.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
PUT /live_stream_key/{id}
{id}Updates a live stream key: rename it, change its default flag, and/or rotate (reset) the stream key value. The same endpoint handles all three.
AuthorizationOnly parent accounts can update live stream keys of their sub-accounts. Sub-account-tier callers are rejected.
HTTP Method & Path
PUT /live_stream_key/{id}
Base URL: https://api-v2.pandavideo.com.br
Authentication Requirements
- Security Scheme:
PandaAuth(apiKey) - Header:
Authorization: <your_api_token>(no Bearer prefix)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Authorization | header | string | Yes | Panda API token (without Bearer prefix) |
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string (uuid) | Yes | ID of the live stream key |
Request Body
Content-Type: application/json
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Display name for the stream key (minLength 3) |
reset_stream_key | boolean | No | If true, rotates the stream key value to a new one |
set_default | boolean | No | Make this the default key (clears default on sibling keys) |
titleis always required — even when you only want to reset the key or change the default, you must resend thetitle. Unknown fields are rejected (additionalProperties: false).
Blocked while live: if a live is currentlyonlineon this key, the update fails with400 "live online using this key".
Example — rename + reset
{ "title": "Updated Stream Title", "reset_stream_key": true }Response
Success Response (200)
{
"id": "08d7f7aa-25ff-47af-9892-b5e52c6b5a93",
"title": "Updated Stream Title",
"stream_key": "d377666e-a3a8-410f-a5a3-d80e5b2b2888",
"created_at": "2026-04-22T15:36:19.323Z",
"default": false,
"subaccount_id": "efcb5915-df17-46b6-bfd8-e8998bc94917"
}stream_key changes only when reset_stream_key: true was sent.
Error Responses
- 400 Bad Request — validation error (missing
title, etc.);"live online using this key";"Subaccounts are not allowed to update stream keys". - 401 Unauthorized — Invalid or missing API token.
- 404 Not Found —
"stream key was not found". - 500 Internal Server Error — Server error.
Example Usage
cURL
curl -X PUT \
'https://api-v2.pandavideo.com.br/live_stream_key/your_key_id_here' \
-H 'Authorization: your_api_token_here' \
-H 'Content-Type: application/json' \
-d '{ "title": "Updated Stream Title", "reset_stream_key": true }'