diff --git a/mkdocs/docs/api/playlist.md b/mkdocs/docs/api/playlist.md
index ddb110b..9136a1f 100644
--- a/mkdocs/docs/api/playlist.md
+++ b/mkdocs/docs/api/playlist.md
@@ -16,5 +16,11 @@ Subscribe/Unsubscribe to a list of playlists:
 ## Playlist Item
 **GET** `/api/playlist/<playlist_id>/`
 
+Delete playlist, metadata only:  
+**DELETE** `/api/playlist/<playlist_id>/`  
+Delete playlist, also delete all videos in playlist:  
+**DELETE** `/api/playlist/<playlist_id>/?delete-videos=true`  
+
+
 ## Playlist Videos
 **GET** `/api/playlist/<playlist_id>/video/`