Merge pull request #7238 from keboola/vb/DMD-1317/exposure_delete

DMD-1317 Bucket Listing: Delete endpoint (DELETE /buckets/{bucketId}/listing)

Author: vojtabiberle

apiary.apib

@@ -2027,6 +2027,54 @@ Asynchronous call response (async=true) that creates a new job. To see job detai
             }
 
 
+### Delete Bucket Listing [DELETE /v2/storage/buckets/{bucket_id}/listing]
+Removes the bucket listing. The listing is removed from the Analytics Hub exchange
+and the listing record is deleted. The underlying exchange is retained for future
+listings in the same project. The operation is idempotent: if the listing has
+already been removed in the target backend, the job still completes successfully.
+
++ Parameters
+    + bucket_id (required) - Bucket Id
+
++ Request
+    + Headers
+
+            X-StorageApi-Token: your_token
+
++ Response 202
+Asynchronous call response (async=true) that creates a new job. To see job detail use [Job Detail API endpoint](#reference/jobs/manage-jobs/job-detail)
+    + Body
+
+            {
+                "id": 11,
+                "status": "waiting",
+                "url": "https://connection.keboola.com/v2/storage/jobs/11",
+                "operationName": "bucketListingDelete",
+                "operationParams": {
+                    "params": {
+                        "queue": "main"
+                    }
+                },
+                "createdTime": "2026-04-24T16:11:05+0200",
+                "startTime": null,
+                "endTime": null,
+                "runId": null,
+                "results": null,
+                "creatorToken": {
+                    "id": "27978",
+                    "description": "ondrej.popelka@keboola.com"
+                },
+                "metrics": {
+                    "inCompressed": false,
+                    "inBytes": 0,
+                    "inBytesUncompressed": 0,
+                    "outCompressed": false,
+                    "outBytes": 0,
+                    "outBytesUncompressed": 0
+                }
+            }
+
+
 ### Force unlink a bucket from a project  [DELETE /v2/storage/buckets/{bucket_id}/links/{linkedProjectId}?async={async}]
 
 When bucket is shared and someone links it, it effectively prevents the owner of the data from revoking the share.