PUT /live_stream_key/{id}

Updates a stream key: rename it, change its default flag, and/or rotate (reset) the stream_key value. The same endpoint handles all three.

📘

Authorization

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

⚠️

Blocked while the key is broadcasting. If a live is currently online on this key, the call fails with 400 "live online using this key". Finish the live first — see Finish live.

⚠️

Resetting invalidates the current key. After reset_stream_key: true the previous stream_key stops working: update the encoder with the new value before the next broadcast.

HTTP Method & Path

PUT /live_stream_key/{id}

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Parameters

Path Parameters

Request Body

Content-Type: application/json

🚧

title is always required — even when all you want is to reset the key or change the default, you must resend the title. Unknown fields are rejected (additionalProperties: false).

📘

The region of a key cannot be changed. region is set when the key is created and is not accepted here. To publish from the other region, create another key with POST /live_stream_key.

Example — rename and rotate the secret

{ "title": "Canal principal", "reset_stream_key": true }

Response

Success Response (200)

{
  "id": "{stream_key_id}",
  "title": "Canal principal",
  "stream_key": "{new_stream_key}",
  "created_at": "2026-09-07T02:30:00.000Z",
  "default": false,
  "subaccount_id": null
}

stream_key changes only when reset_stream_key: true was sent.

Error Responses

• 400 Bad Request — validation error (missing or too short title); "live online using this key"; "Subaccounts are not allowed to update stream keys".
• 401 Unauthorized — missing or invalid API token.
• 404 Not Found — "stream key was not found".
• 500 Internal Server Error — server-side error.

Example Usage

cURL — rename and rotate

curl -X PUT "https://api-v2.pandavideo.com.br/live_stream_key/{stream_key_id}" \
  -H "Authorization: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Canal principal", "reset_stream_key": true }'

Related

• Stream Keys — list the keys and read is_attached before rotating.
• Create Live Stream Key — create a key, choosing its region.
• Delete Live Stream Key — remove a key.