Implemented the DELETE /users/{username}/collection/folders/{folder_id}/releases/{release_id}/instances/{instance_id} endpoint for the Open API specification document in the library target.

2025-10-16 02:41:24 +02:00
parent f5e4d4604a
commit a342814bd3
1 changed files with 36 additions and 0 deletions
@@ -1415,6 +1415,42 @@ paths:
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalError'
+    delete:
+      tags:
+        - User Collection
+      summary: Delete a specified release instance in a specified collection folder of a user.
+      description: |
+        Removes an instance of a release from a collection folder of a user.
+        
+        > important: To move the release to the *Uncategorized* folder instead, use the `POST` method.
+        
+        This endpoint requires authentication as the collection owner.
+      operationId: deleteInstanceFromCollectionFolder
+      parameters:
+        - $ref: '#/components/parameters/Username'
+        - $ref: '#/components/parameters/FolderId'
+        - $ref: '#/components/parameters/ReleaseId'
+        - $ref: '#/components/parameters/InstanceId'
+      security:
+        - ConsumerKeySecret: []
+        - UserToken: []
+        - OAuth: []
+      responses:
+        '204':
+          description: Successfully deleted a specific release instance inside a collection folder of a user. 
+          headers:
+            X-Discogs-RateLimit:
+              $ref: '#/components/headers/RateLimit'
+            X-Discogs-RateLimit-Used:
+              $ref: '#/components/headers/RateLimitUsed'
+            X-Discogs-RateLimit-Remaining:
+              $ref: '#/components/headers/RateLimitRemaining'
+        '403':
+          $ref: '#/components/responses/NotAccessable'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalError'
 components:
  headers:
    Link: