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

{
  "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.

200Playlist updated successfully

400Bad request - Invalid input parameters

404Not found - Resource does not exist

500Internal server error