Skip to content

CLI reference — Capabilities

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.

9 operations in this area.

Backfill web access for existing hasBrowserUi capabilities (Admin only)

CLI (preferred):

Terminal window
nayaone-admin api adminBackfillCapabilityWebAccess --body '{}'

REST fallback: POST /admin-api/capabilities/backfill-web-access

Install docker+kasmvnc+neko on eligible VM boxes (bounded batch)

CLI (preferred):

Terminal window
nayaone-admin api adminInstallDefaultRemoteDesktopFleet --body '{}'

REST fallback: POST /admin-api/capabilities/install-default-remote-desktop-fleet

Install tailscale on active ssh/rdp boxes in ready-Headscale orgs (bounded batch)

CLI (preferred):

Terminal window
nayaone-admin api adminInstallTailscaleMeshFleet --body '{}'

REST fallback: POST /admin-api/capabilities/install-tailscale-mesh-fleet

List boxes with an error-state singleton capability (no healthy instance, not a Phase R duplicate group)

CLI (preferred):

Terminal window
nayaone-admin api adminListErrorStateSingletonFleet

REST fallback: GET /admin-api/capabilities/error-state-singleton-fleet

List daemon-reported singleton containers with no live D1 instance row (orphans)

CLI (preferred):

Terminal window
nayaone-admin api adminListOrphanSingletonFleet

REST fallback: GET /admin-api/capabilities/orphan-singleton-fleet

List boxes with >1 live instance of a singleton_per_box capability

CLI (preferred):

Terminal window
nayaone-admin api adminListSingletonDuplicateFleet

REST fallback: GET /admin-api/capabilities/singleton-duplicate-fleet

adminPruneDuplicateDefaultRemoteDesktopFleet

Section titled “adminPruneDuplicateDefaultRemoteDesktopFleet”

Delete duplicate docker/kasmvnc/neko instances per box (keep best row)

CLI (preferred):

Terminal window
nayaone-admin api adminPruneDuplicateDefaultRemoteDesktopFleet --body '{}'

REST fallback: POST /admin-api/capabilities/prune-duplicate-default-remote-desktop-fleet

Delete duplicate instances of any singleton_per_box capability (keep best row)

CLI (preferred):

Terminal window
nayaone-admin api adminPruneSingletonDuplicateFleet --body '{}'

REST fallback: POST /admin-api/capabilities/prune-singleton-duplicate-fleet

PATCH CF Access policies for every existing capability deployment (Admin only)

CLI (preferred):

Terminal window
nayaone-admin api adminResyncCapabilityWebAccess --body '{}'

REST fallback: POST /admin-api/capabilities/resync-web-access