Reloops CLI and Public API

The Reloops CLI wraps the public agent API used by developer keys. Use it when an agent or workflow needs a scriptable path into the same workspaces, projects, assets, comments, collections, screenshots, uploads, and share links that the web app uses.

Install and configure

Install the CLI or run it with npx:

npm install -g reloops-cli
npx reloops-cli --help

Set the developer key generated from AI Agents and Developer Keys:

export RELOOPS_API_KEY="reloops_live_YOUR_API_KEY"

The production API base is:

https://api.reloops.app/functions/v1

For local Supabase development, pass --local or set RELOOPS_BASE_URL:

reloops-cli --local workspaces list
RELOOPS_BASE_URL="http://127.0.0.1:54321/functions/v1" reloops-cli workspaces list

Common commands

reloops-cli doctor
reloops-cli assigned requested-review --limit 10
reloops-cli actors list
reloops-cli workspaces list
reloops-cli projects list --workspace-id ws_123
reloops-cli projects tree proj_123
reloops-cli assets search --workspace-id ws_123 --query "approved launch videos"
reloops-cli assets semantic-search --workspace-id ws_123 --query "brand logo on dark background"
reloops-cli comments create --asset-id asset_123 --body "Tighten the intro pacing." --media-ms-start 2000
reloops-cli screenshots create --workspace-id ws_123 --project-id proj_123 --url https://example.com
reloops-cli shares create --asset-id asset_123

Preview a request without sending it:

reloops-cli --dry-run assets update asset_123 --status approved

Upload a file

Use the single-file helper for normal uploads:

reloops-cli upload single-file ./final.mp4 --workspace-id ws_123 --project-id proj_123 --folder-id folder_123

For larger or custom upload flows, use the upload control-plane commands:

upload start
upload sign
upload sign-batch
upload complete
upload abort

Command surface

The CLI covers the main public API surface:

Area	Commands
Assigned work	`assigned list`, `assigned requested-review`
Actors	`actors list`
Workspaces	`workspaces list`, `workspaces create`
Projects	`projects list`, `projects create`, `projects get`, `projects tree`, `projects update`, `projects counts`
Folders	`projects folders list`, `create`, `items`, `update`, `move`, `delete`, `bulk-move`
Assets	`assets list`, `library`, `search`, `semantic-search`, `get`, `projects`, `update`, `status`, `assign-agent`, `unassign`, `delete`, `delete-stack`, `move-folder`, `stack`, `versions`
Bulk asset transfers	`assets bulk copy-to-project`, `assets bulk move-to-project`
Comments	`comments list`, `create`, `update`, `edit`, `status`, `delete`
Collections	`collections list`, `create`, `get`, `update`, `items`, `delete`
Website review	`screenshots create`
Sharing	`shares create`, `shares create-collection`, `shares list-asset`, `shares list-project`, `shares list-collection`, `shares revoke`
Uploads	`upload single-file`, `complete-single`, `start`, `sign`, `sign-batch`, `complete`, `abort`

Use raw when an endpoint exists before the CLI has a first-class command:

reloops-cli raw PATCH api-assets/asset_123 --body '{"status":"approved"}'

Authentication

Pass the developer key as a Bearer token. The CLI does this automatically when RELOOPS_API_KEY is set.

curl https://api.reloops.app/functions/v1/api-workspaces \
  -H "Authorization: Bearer reloops_live_YOUR_API_KEY"

API keys are scoped to the organization that created them. The API only returns workspaces and assets available to that organization.

Get Started

Projects & Assets

AI & DAM

Collections

Review & Sharing

Workspace & Team

Developers & Agents

FAQ

Reloops CLI and Public API

Install and configure

Common commands

Upload a file

Command surface

Authentication

​Install and configure

​Common commands

​Upload a file

​Command surface

​Authentication

Install and configure

Common commands

Upload a file

Command surface

Authentication