From b262a56dda91b7c69439587e1ec09ff728848753 Mon Sep 17 00:00:00 2001
From: lukehagar <lukeslakemail@gmail.com>
Date: Mon, 10 Apr 2023 13:38:45 +0000
Subject: [PATCH] Updating OpenAPI Spec

---
 static/plex-api-spec-dereferenced.yaml | 85 +++++++++++++++++++++++++-
 1 file changed, 84 insertions(+), 1 deletion(-)

diff --git a/static/plex-api-spec-dereferenced.yaml b/static/plex-api-spec-dereferenced.yaml
index f147807..3f1665b 100644
--- a/static/plex-api-spec-dereferenced.yaml
+++ b/static/plex-api-spec-dereferenced.yaml
@@ -752,6 +752,89 @@ paths:
           description: The playlist
         '401':
           description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
+    delete:
+      tags:
+        - Playlists
+      summary: Delete a Playlist
+      description: |
+        This endpoint will delete a playlist
+      operationId: deletePlaylist
+      parameters:
+        - name: playlistID
+          description: the ID of the playlist
+          in: path
+          schema:
+            type: number
+          required: true
+      responses:
+        '200':
+          description: The playlist is deleted
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
+    put:
+      tags:
+        - Playlists
+      summary: Update a Playlist
+      description: |
+        This endpoint will delete a playlist
+      operationId: updatePlaylist
+      parameters:
+        - name: playlistID
+          description: the ID of the playlist
+          in: path
+          schema:
+            type: number
+          required: true
+      responses:
+        '200':
+          description: The playlist is deleted
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
+  '/playlists/{playlistID}/items':
+    get:
+      tags:
+        - Playlists
+      summary: Retrieve Playlist Contents
+      description: |
+        This endpoint will return the contents of a playlist
+      operationId: getPlaylistContent
+      parameters:
+        - name: playlistID
+          description: the ID of the playlist
+          in: path
+          schema:
+            type: number
+          required: true
+        - name: type
+          description: the metadata type of the item to return
+          in: query
+          schema:
+            type: number
+          required: true
+      responses:
+        '200':
+          description: The playlist contents
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
+    delete:
+      tags:
+        - Playlists
+      summary: Delete Playlist Contents
+      description: |
+        This endpoint will clear the contents of a playlist
+      operationId: clearPlaylistContent
+      parameters:
+        - name: playlistID
+          description: the ID of the playlist
+          in: path
+          schema:
+            type: number
+          required: true
+      responses:
+        '200':
+          description: The playlist contents are cleared
+        '401':
+          description: Unauthorized - Returned if the X-Plex-Token is missing from the header or query.
 tags:
   - name: Activities
     description: |
@@ -784,7 +867,7 @@ tags:
   - name: Hubs
     description: |
       Hubs are a structured two-dimensional container for media, generally represented by multiple horizontal rows.
-  - name: Playlist
+  - name: Playlists
     description: |
       Playlists are ordered collections of media. They can be dumb (just a list of media) or smart (based on a media query, such as "all albums from 2017"). They can be organized in (optionally nesting) folders.
       Retrieving a playlist, or its items, will trigger a refresh of its metadata. This may cause the duration and number of items to change.