API Reference

Update 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

NameTypeRequiredDescription
Authorizationstring (header)YesPanda API token (without Bearer prefix)
playlist_idstring (path, uuid)YesUnique identifier of the playlist to update.

Request Body

Schema: UpdatePlaylistRequest

All properties are optional unless noted.

NameTypeRequiredDescription
namestringNominLength=1, maxLength=255.
descriptionstringNomaxLength=1000.
access_typestringNoOne of public, private, anyone_with_password.
passwordstringConditionallyRequired when changing access_type to anyone_with_password. minLength=6.
hide_viewsbooleanNoToggle visibility of total views.
creator_namestringNominLength=1, maxLength=255.
external_buttonobject (ExternalButton)NoExternal CTA button.
image_idstring (uuid)NoCover image identifier.

Schema: 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.
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!