Added DELETE method for deleting an episode to the apiv2.

CHANGELOG.md

@@ -6,6 +6,7 @@
 #### Improvements
 - Vueified "config - notifications" page. Improved components: config-textbox, select-list, show-selector, config-textbox-number. Improved responsiveness of the notification page on smaller screens ([#4913](https://github.com/pymedusa/Medusa/pull/4913))
 - Allow the use of priorities in the Pushover notifier ([#5567](https://github.com/pymedusa/Medusa/pull/5567))
+- Add delete method to EpisodeHandler (apiv2), for deleting a single episode ([#5685](https://github.com/pymedusa/Medusa/pull/5685))
 
 #### Fixes
 - Fixed test not working for Download Station ([#5561](https://github.com/pymedusa/Medusa/pull/5561))

dredd/api-description.yml

@@ -324,6 +324,34 @@ paths:
               {"status": 2, "quality": 4}
             path-params:
               id: e999
+    delete:
+      summary: Delete a specific episode from a given series
+      description: Delete a specific episode from a given series
+      parameters:
+        - $ref: '#/parameters/series-id'
+          name: seriesid
+        - $ref: '#/parameters/episode-id-delete'
+          name: id
+      responses:
+        204:
+          description: Episode is deleted successfully
+        400:
+          $ref: '#/responses/error'
+          description: Invalid id
+          x-request:
+            path-params:
+              seriesid: tvdb301824
+              id: 123456
+        404:
+          $ref: '#/responses/error'
+          description: Episode not found
+          x-request:
+            path-params:
+              seriesid: tvdb301824
+              id: s9999e9999
+        409:
+          $ref: '#/responses/error'
+          description: Unable to delete episode
   /series/{seriesid}/episodes/{id}/{field}:
     get:
       summary: Return a specific field from a given episode
@@ -2342,6 +2370,13 @@ parameters:
     description: The episode id to retrieve. E.g. s02e03, e34 or 2016-12-31
     x-example: s01e01
     type: string
+  episode-id-delete:
+    name: episode-id
+    in: path
+    required: true
+    description: The episode id to retrieve. E.g. s02e03, e34 or 2016-12-31
+    x-example: s01e02
+    type: string
   alias-id:
     name: alias-id
     in: path

medusa/server/api/v2/episodes.py

@@ -4,6 +4,7 @@
 
 import logging
 
+from medusa.helper.exceptions import EpisodeDeletedException
 from medusa.logger.adapters.style import BraceAdapter
 from medusa.server.api.v2.base import (
     BaseRequestHandler,
@@ -36,7 +37,7 @@ class EpisodeHandler(BaseRequestHandler):
     #: path param
     path_param = ('path_param', r'\w+')
     #: allowed HTTP methods
-    allowed_methods = ('GET', 'PATCH', )
+    allowed_methods = ('GET', 'PATCH', 'DELETE',)
 
     def http_get(self, series_slug, episode_slug, path_param):
         """Query episode information.
@@ -156,3 +157,31 @@ def _patch_episode(episode, data):
             )
 
         return accepted
+
+    def http_delete(self, series_slug, episode_slug, **kwargs):
+        """Delete the episode."""
+        if not series_slug:
+            return self._method_not_allowed('Deleting multiple series are not allowed')
+
+        identifier = SeriesIdentifier.from_slug(series_slug)
+        if not identifier:
+            return self._bad_request('Invalid series identifier')
+
+        series = Series.find_by_identifier(identifier)
+        if not series:
+            return self._not_found('Series not found')
+
+        episode_number = EpisodeNumber.from_slug(episode_slug)
+        if not episode_number:
+            return self._bad_request('Invalid episode number')
+
+        episode = Episode.find_by_series_and_episode(series, episode_number)
+        if not episode:
+            return self._not_found('Episode not found')
+
+        try:
+            episode.delete_episode()
+        except EpisodeDeletedException:
+            return self._no_content()
+        else:
+            return self._conflict('Unable to delete episode')