- AssetsUnreferencedAction now accepts an optional previewToken parameter, skipping the SpaceApi call when provided (useful for OAuth-only applications)

Author: roberto-butti

.claude/commands/blokctl-api.md

@@ -48,7 +48,7 @@ Every CLI command is backed by a reusable Action class with no CLI dependencies:
 | `Story\StoryVersionsAction` | List story versions | `->versions`, `->storyId`, `->count()` |
 | `Story\StoriesWorkflowAssignAction` | Assign stage to unstaged stories (preflight+execute) | `->countWithoutStage`, `->workflowStages` |
 | `Asset\AssetsListAction` | List/search assets (MAPI only) | `->assets`, `->count()` |
-| `Asset\AssetsUnreferencedAction` | Find unreferenced assets | `->unreferencedAssets`, `->totalAssets`, `->referencedCount`, `->storiesAnalyzed` |
+| `Asset\AssetsUnreferencedAction` | Find unreferenced assets (optional `previewToken`) | `->unreferencedAssets`, `->totalAssets`, `->referencedCount`, `->storiesAnalyzed` |
 | `Workflow\WorkflowsListAction` | List workflows+stages | `->workflows`, `->count()` |
 | `Workflow\WorkflowStageShowAction` | Show stage details | `->stage`, `->workflowName` |
 | `Component\ComponentsListAction` | List/filter components | `->components`, `->count()` |

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 All notable changes to `blokctl` will be documented in this file.
 
+## 0.6.2 - 2026-04-03
+- `AssetsUnreferencedAction` now accepts an optional `previewToken` parameter, skipping the SpaceApi call when provided (useful for OAuth-only applications)
+
 ## 0.6.1 - 2026-04-03
 - Adding `assets:list`: List assets with optional search filter via Management API
 

README.md

@@ -1319,6 +1319,7 @@ use Blokctl\Action\Asset\AssetsUnreferencedAction;
 $result = (new AssetsUnreferencedAction($client))->execute(
     spaceId: $spaceId,
     region: 'EU',
+    previewToken: $token,     // optional — skips SpaceApi call when provided
     assetsPerPage: 1000,
     storiesPerPage: 100,
 );
@@ -1330,7 +1331,7 @@ $result->storiesAnalyzed;    // int
 $result->unreferencedCount(); // int
 ```
 
-Fetches all assets via the Management API (up to 1000/page), then scans all stories via the Content Delivery API (higher rate limits) for asset references. Returns the set difference.
+Fetches all assets via the Management API (up to 1000/page), then scans all stories via the Content Delivery API (higher rate limits) for asset references. Returns the set difference. Pass `previewToken` to skip the SpaceApi lookup (useful for OAuth-only applications).
 
 ### Components
 

src/Action/Asset/AssetsUnreferencedAction.php

@@ -25,6 +25,7 @@ public function __construct(
     public function execute(
         string $spaceId,
         string $region = 'EU',
+        ?string $previewToken = null,
         int $assetsPerPage = 1000,
         int $storiesPerPage = 100,
     ): AssetsUnreferencedResult {
@@ -62,8 +63,7 @@ public function execute(
         }
 
         // Step 2: Get preview token and set up CDN client
-        $space = (new SpaceApi($this->client))->get($spaceId)->data();
-        $token = $space->firstToken();
+        $token = $previewToken ?? (new SpaceApi($this->client))->get($spaceId)->data()->firstToken();
 
         if ($token === '') {
             throw new \RuntimeException('No preview access token found for this space.');