Create a new playlist

This endpoint creates a new playlist within a specified workspace. A playlist acts as a container for organizing media items either manually or based on filters and metadata.

Playlists can be created in two modes

• Manual: An empty playlist is created without any initial media items. It’s intended for manual curation, where items can be added later in a user-defined sequence.
• Smart: The playlist is auto-populated at creation time based on filters (video creation date range) criteria provided in the request.

How it works

• When a user sends a POST request to this endpoint, FastPix creates a playlist and returns a playlist ID, using which items can be added later in a user-defined sequence.
• For a smart playlist, the playlist will be auto-populated based on metadata in the request body.

Example

An e-learning platform creates a new playlist titled "Beginner Python Series" via the API. The response includes a unique playlist ID. The platform then uses this ID to add a series of video tutorials to the playlist in a defined order. The playlist is presented to learners on the frontend as a structured learning path.