Playlists

User playlists. Each call is scoped to the authenticated user — owners and collaborators see different things based on their permission level.

Endpoints

To list the tracks inside a playlist, use the catalog endpoint:

GET /api/v4/{locale}/tracks/?user_playlist={slug}

This is the same endpoint that powers track browsing; the user_playlist filter scopes it to one of your playlists.

Authentication

All playlist endpoints require an authenticated request. Send your token:

Authorization: Bearer <PARTNER_API_KEY>

The user identity is derived from the token. Partners that act on behalf of an end user should make sure that user is signed in to the relevant Slipstream account first.

Permissions

A playlist has one owner and any number of collaborators.

Endpoints return 403 Forbidden when the caller lacks permission.

The Playlist object

{
  "id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
  "name": "Late Night",
  "slug": "late-night",
  "description": "Reflective jazz under 120 BPM",
  "owner": {
    "id": "1e2d3c4b-5a69-4f78-9012-345678abcdef",
    "username": "user-12345",
    "name": "Sam Editor"
  },
  "permission": "owner",
  "playlist_type": "user",
  "tracks": 12,
  "duration": 2814,
  "url": "/playlists/late-night",
  "blurhash": "L6PZfSi_.AyE_3t7t7R**0o#DgR4",
  "all_image_sizes": {
    "small":  "https://...",
    "medium": "https://...",
    "large":  "https://..."
  },
  "collaborators": [
    { "id": "...", "username": "...", "permission": "can_edit" }
  ]
}

Pagination

list uses limit/offset:

Errors