Update playlist

PUT https://api-v2.pandavideo.com/playlists/{playlist_id}

Updates an existing playlist

PUT /playlists/{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 /playlists/{playlist_id}

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).
playlist_id	path	string (uuid)	Yes	Unique identifier of the playlist to update.

Request Body

Schema: 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.

ExternalButton

Name	Type	Required	Description
size	string	Yes	One of small, medium, large.
text	string	Yes	Button label. minLength=1, maxLength=50.
url	string (uri)	Yes	Destination URL.

Example Request Body

JSON

{
  "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 password during the same update request.