Paperclip Manage Companies

name paperclip-manage-companies description Manage Paperclip companies — create, list, update settings, archive, import/export portable bundles, and configure branding. Prerequisites Role: board operator / instance admin with local_trusted mode Instance API at http://localhost:3100 (override with PAPERCLIP_API_URL ) jq installed for JSON formatting Set shell variables before running examples: export BASE= ${PAPERCLIP_API_URL:-http://localhost:3100} export COMPANY_ID=<your-company-id> CompanyStatus values Status Meaning active Normal operation paused Agents suspended, data preserved archived Read-only, hidden from default views List and Inspect List all companies pnpm paperclipai company list Get a single company pnpm paperclipai company get $COMPANY_ID Aggregated stats across all companies curl -s $BASE /api/companies/stats | jq Create a Company curl -s -X POST $BASE /api/companies
-H "Content-Type: application/json"
-d '{ "name": "Acme Corp", "description": "Primary production company", "budgetMonthlyCents": 50000 }' | jq Fields: Field Type Description name string Display name (required) description string Optional description budgetMonthlyCents number Monthly LLM cost cap in cents Update a Company curl -s -X PATCH $BASE /api/companies/ $COMPANY_ID -H "Content-Type: application/json" -d '{ "name": "Acme Corp (Updated)", "status": "paused", "requireBoardApprovalForNewAgents": true }' | jq Updatable fields include name , description , status , budgetMonthlyCents , requireBoardApprovalForNewAgents . Pause a company curl -s -X PATCH $BASE /api/companies/ $COMPANY_ID -H "Content-Type: application/json" -d '{"status": "paused"}' | jq Reactivate a company curl -s -X PATCH $BASE /api/companies/ $COMPANY_ID -H "Content-Type: application/json" -d '{"status": "active"}' | jq Branding curl -s -X PATCH $BASE /api/companies/ $COMPANY_ID /branding -H "Content-Type: application/json" -d '{ "brandColor": "#4F46E5", "name": "Acme" }' | jq brandColor accepts any valid CSS hex color. name sets the short display name used in the UI header. Archive a Company Archiving suspends all agents and makes the company read-only. Data is preserved. curl -s -X POST $BASE /api/companies/ $COMPANY_ID /archive | jq To restore an archived company, update its status back to active : curl -s -X PATCH $BASE /api/companies/ $COMPANY_ID -H "Content-Type: application/json" -d '{"status": "active"}' | jq Export and Import Export a company bundle pnpm paperclipai company export $COMPANY_ID --out ./export --include company,agents,projects,issues --include accepts a comma-separated list. Omit to export everything. Import a company bundle