From a342814bd3059e828c5a5f6e7dac7d3abde202f1 Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Thu, 16 Oct 2025 02:41:24 +0200
Subject: [PATCH] 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.

---
 Sources/DiscogsService/openapi.yaml | 36 +++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index f7381dfef..1b3eac250 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -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: