Skip to content

CLI reference — Storage

Generated by bun run generate:cli-reference from spec/admin-api-openapi.json. Do not hand-edit — regenerate after refreshing the spec.

Every operation below is documented CLI-first (nayaone-admin api <operationId>) per PRD-407/DO-7. The REST /admin-api/* method+path is the fallback/alternative integration option.

7 operations in this area.

Mint a share link for a runner-scoped volume (platform admin)

CLI (preferred):

Terminal window
nayaone-admin api adminCreateStorageShareLink --param storageId=<storageId> --body '{}'

REST fallback: POST /admin-api/storage/{storageId}/share-link

Revoke a share link on a runner-scoped volume

CLI (preferred):

Terminal window
nayaone-admin api adminDeleteStorageShareLink --param storageId=<storageId> --param linkId=<linkId> --body '{}'

REST fallback: DELETE /admin-api/storage/{storageId}/share-links/{linkId}

Latest usage snapshot for a runner-scoped volume (platform admin)

CLI (preferred):

Terminal window
nayaone-admin api adminGetStorageUsage --param storageId=<storageId>

REST fallback: GET /admin-api/storage/{storageId}/usage

Issue short-TTL credentials for a runner-scoped volume (platform admin)

CLI (preferred):

Terminal window
nayaone-admin api adminIssueStorageBrowserCredentials --param storageId=<storageId> --body '{}'

REST fallback: POST /admin-api/storage/{storageId}/browser-creds

List share links for a runner-scoped volume

CLI (preferred):

Terminal window
nayaone-admin api adminListStorageShareLinks --param storageId=<storageId>

REST fallback: GET /admin-api/storage/{storageId}/share-links

Rolling-window usage history for a runner-scoped volume

CLI (preferred):

Terminal window
nayaone-admin api adminListStorageUsageHistory --param storageId=<storageId>

REST fallback: GET /admin-api/storage/{storageId}/usage/history

Force a fresh usage measurement for a runner-scoped volume

CLI (preferred):

Terminal window
nayaone-admin api adminRefreshStorageUsage --param storageId=<storageId> --body '{}'

REST fallback: POST /admin-api/storage/{storageId}/usage/refresh