Merge branch 'master' into devin/DMD-613-1761050115

Author: jirkasemmler

apiary.apib

@@ -5828,6 +5828,63 @@ Delete specified workspace credentials. User will be invalidated
 
 
 
+## Workspace Unload [/v2/storage/workspaces/{workspace_id}/unload]
+
+### Unload workspace data [POST]
+
+Validates Snowflake transformation component configuration and examines output mapping strategies for direct-grant tables.
+Returns an array of jobs instead of a single job.
+
++ Parameters
+    + workspace_id (required, number) - Workspace ID
+
++ Attributes
+    + only-direct-grants (optional, boolean) - Will unload only tables with direct-grant unload strategy no others.
+        Default: false
+
++ Request (application/json)
+    + Headers
+
+            X-StorageApi-Token: your_token
+
++ Response 202 (application/json)
+    + Body
+
+            [
+                {
+                    "id": 75682260,
+                    "status": "created",
+                    "url": "https://connection.keboola.com/v2/storage/jobs/75682260",
+                    "tableId": null,
+                    "operationName": "workspaceUnload",
+                    "operationParams": {
+                        "workspaceId": "504345774",
+                        "table": {
+                            "source": "out.c-bucket.table1",
+                            "outputMappingStrategy": "direct-grant"
+                        },
+                        "onlyDirectGrants": false
+                    },
+                    "createdTime": "2025-10-22T10:15:52+0200",
+                    "startTime": null,
+                    "endTime": null,
+                    "runId": null,
+                    "results": null,
+                    "creatorToken": {
+                        "id": "27978",
+                        "description": "user@keboola.com"
+                    },
+                    "metrics": {
+                        "inCompressed": false,
+                        "inBytes": 0,
+                        "inBytesUncompressed": 0,
+                        "outCompressed": false,
+                        "outBytes": 0,
+                        "outBytesUncompressed": 0
+                    }
+                }
+            ]
+
 ## Data Structures
 
 ### Workspace

src/Keboola/StorageApi/Workspaces.php

@@ -187,6 +187,26 @@ public function queueWorkspaceCloneInto(int $id, array $options = []): int
         return (int) $job['id'];
     }
 
+    /**
+     * Queue workspace unload operation
+     *
+     * @param int $id Workspace ID
+     * @param array $options Optional parameters (e.g., only-direct-grants)
+     * @return array Array of job IDs
+     */
+    public function queueUnload(int $id, array $options = []): array
+    {
+        $url = "workspaces/{$id}/unload";
+        if (!empty($options)) {
+            $url .= '?' . http_build_query($options);
+        }
+
+        $jobs = $this->client->apiPostJson($url, [], false);
+        assert(is_array($jobs));
+
+        return array_map(fn($job) => (int) $job['id'], $jobs);
+    }
+
     public function executeQuery(int $id, string $query): array
     {
         $result = $this->client->apiPostJson(