feat: delete usertitle described

api/paths/users-id-titles.yaml

@@ -117,11 +117,10 @@ post:
               type: integer
               format: int64
             status:
-              $ref: ../schemas/enums/UserTitleStatus.yaml
+              $ref: '../schemas/enums/UserTitleStatus.yaml'
             rate:
               type: integer
               format: int32
-
   responses:
     '200':
       description: Title successfully added to user
@@ -169,7 +168,7 @@ patch:
               type: integer
               format: int64
             status:
-              $ref: ../schemas/enums/UserTitleStatus.yaml
+              $ref: '../schemas/enums/UserTitleStatus.yaml'
             rate:
               type: integer
               format: int32
@@ -190,5 +189,33 @@ patch:
       description: Forbidden — user not allowed to update title
     '404':
       description: User or Title not found
+    '500':
+      description: Internal server error
+
+delete:
+  summary: Delete a usertitle
+  description: User deleting title from list of watched
+  operationId: deleteUserTitle
+  parameters:
+    - name: user_id
+      in: path
+      required: true
+      schema:
+        type: integer
+        format: int64
+      description: ID of the user to assign the title to
+      example: 123
+
+  responses:
+    '200':
+      description: Title successfully deleted
+    # '400':
+    #   description: Invalid request body (missing fields, invalid types, etc.)
+    '401':
+      description: Unauthorized — missing or invalid auth token
+    '403':
+      description: Forbidden — user not allowed to delete title
+    '404':
+      description: User or Title not found
     '500':
       description: Internal server error