put https://api-v2.pandavideo.com/playlist/
Updates an existing playlist
PUT /playlist/{playlist_id}
Detailed Description
Updates an existing playlist’s metadata and access settings. Use this to rename the playlist, change visibility, update the external button, or modify the cover image.
HTTP Method & Path
PUT /playlist/{playlist_id}
Authentication Requirements
- Security Scheme:
PandaAuth
(apiKey) - Header:
Authorization: <your_api_token>
(no Bearer prefix)
Parameters
Name | Type | Required | Description |
---|---|---|---|
Authorization | string (header) | Yes | Panda API token (without Bearer prefix) |
playlist_id | string (path, uuid) | Yes | Unique identifier of the playlist to update. |
Request Body
Schema: UpdatePlaylistRequest
UpdatePlaylistRequest
All properties are optional unless noted.
Name | Type | Required | Description |
---|---|---|---|
name | string | No | minLength=1 , maxLength=255 . |
description | string | No | maxLength=1000 . |
access_type | string | No | One of public , private , anyone_with_password . |
password | string | Conditionally | Required when changing access_type to anyone_with_password . minLength=6 . |
hide_views | boolean | No | Toggle visibility of total views. |
creator_name | string | No | minLength=1 , maxLength=255 . |
external_button | object (ExternalButton ) | No | External CTA button. |
image_id | string (uuid) | No | Cover image identifier. |
Schema: ExternalButton
ExternalButton
(See create endpoint for the same structure.)
Example Request Body
{
"name": "My Updated Playlist",
"description": "Updated description",
"access_type": "anyone_with_password",
"password": "secret123",
"hide_views": true,
"external_button": {
"size": "small",
"text": "Shop Now",
"url": "https://store.example.com"
},
"image_id": "a6d1f7c8-1c2b-4d5e-9a10-1b2c3d4e5f60"
}
Notes
- When switching to password-protected access, always provide a compliant
password
during the same update.