{
  "opencollection": "1.0.0",
  "info": {
    "name": "Plex Media Server Playlist API",
    "version": "1.2.2\n"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "X-Plex-Token",
      "value": "{{X-Plex-Token}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Playlist",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Retrieve Playlists",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{IP-description}.{identifier}.plex.direct:{port}/playlists",
            "params": [
              {
                "name": "playlistType",
                "value": "",
                "type": "query",
                "description": "Limit to a type of playlist"
              },
              {
                "name": "smart",
                "value": "",
                "type": "query",
                "description": "Type of playlists to return, smart or not.  When not provided, will return both."
              }
            ]
          },
          "docs": "Gets a list of playlists and playlist folders for a user. General filters are permitted, such as `sort=lastViewedAt:desc`. A flat playlist list can be retrieved using `type=15` to limit the collection to just playlists."
        },
        {
          "info": {
            "name": "Retrieve Playlist",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{IP-description}.{identifier}.plex.direct:{port}/playlists/:playlistId",
            "params": [
              {
                "name": "playlistId",
                "value": "",
                "type": "path",
                "description": "The ID of the playlist"
              }
            ]
          },
          "docs": "Gets detailed metadata for a playlist. A playlist for many purposes (rating, editing metadata, tagging), can be treated like a regular metadata item:\nSmart playlist details contain the `content` attribute. This is the content URI for the generator. This can then be parsed by a client to provide smart playlist editing."
        },
        {
          "info": {
            "name": "Retrieve Playlist Contents",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://{IP-description}.{identifier}.plex.direct:{port}/playlists/:playlistId/items",
            "params": [
              {
                "name": "playlistId",
                "value": "",
                "type": "path",
                "description": "The ID of the playlist"
              },
              {
                "name": "type",
                "value": "",
                "type": "query",
                "description": "The metadata types of the item to return.  Values past the first are only used in fetching items from the background processing playlist."
              }
            ]
          },
          "docs": "Gets the contents if a playlist. Should be paged by clients via standard mechanisms. By default leaves are returned (e.g. episodes, movies). In order to return other types you can use the `type` parameter. For example, you could use this to display a list of recently added albums vis a smart playlist. Note that for dumb playlists, items have a `playlistItemID` attribute which is used for deleting or moving items."
        }
      ]
    }
  ],
  "bundled": true
}