POST /playlists

Detailed Description

Creates a new video playlist for the authenticated user. Use this when starting a curated list of videos with configurable access rules and optional external button metadata.

HTTP Method & Path

POST /playlists

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).

Request Body

Schema: `CreatePlaylistRequest`

Name	Type	Required	Description
name	string	Yes	Playlist name. `minLength=1`, `maxLength=255`.
description	string	No	Optional description. `maxLength=1000`.
access_type	string	Yes	One of `public`, `private`, `anyone_with_password`.
password	string	Conditionally	Required when `access_type=anyone_with_password`. `minLength=6`.
hide_views	boolean	No	Whether to hide total views. Default `false`.
creator_name	string	Yes	Display name of the playlist creator. `minLength=1`, `maxLength=255`.
external_button	object (`ExternalButton`)	No	Optional external call-to-action button.
image_id	string (uuid)	No	Optional 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 Playlist",
  "description": "A collection of tutorial videos",
  "access_type": "public",
  "hide_views": false,
  "creator_name": "John Doe",
  "external_button": {
    "size": "medium",
    "text": "Visit Website",
    "url": "https://example.com"
  },
  "image_id": "a6d1f7c8-1c2b-4d5e-9a10-1b2c3d4e5f60"
}