playlists

Create a new playlist

Creates a new playlist for the authenticated user

post/playlists

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/playlists
  • Auth: none declared

Request body

namestring required

Name of the playlist

slugstring required

Slug of the playlist

descriptionstring required

Description of the playlist

publishedboolean required

Published flag (true to make browseable/searchable by public users, false to make private)

cover_art_track_idinteger

ID of the track whose show cover art represents the playlist (defaults to first track)

track_idsinteger[] required

Array of track IDs that make up the playlist

starts_at_secondinteger[] required

Array of starting positions of associated track selections in track_ids array

ends_at_secondinteger[] required

Array of ending positions of associated track selections in track_ids array

Response

Create a new playlist

idinteger required

ID of the playlist

slugstring required

The unique slug for the playlist

namestring required

The display name of the playlist

descriptionstring required

The description of the playlist

usernamestring required
durationinteger required

The total duration of all tracks in the playlist, in milliseconds

cover_art_track_idinteger required

ID of the track whose show cover art represents the playlist

cover_art_urlsunknown required
tracks_countinteger required

The number of tracks in the playlist

likes_countinteger required

The number of likes the playlist has received

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

publishedboolean required

Indicates if the playlist is listed publicly for other users to browse and search

liked_by_userboolean required

Indicates if the current user has liked this playlist

Changes

No recorded changes to this operation across all 1 revision of this API.