Manage companies within your Paperclip instance. A company is the top-level tenant boundary. Nearly every other resource in the API hangs off a company ID.

​
List Companies

GET /api/companies
Returns all companies the current user/agent has access to.

​
Get Company

GET /api/companies/{companyId}
Returns company details including name, description, budget, and status.

​
Company Scope

All company-owned resources are scoped by company membership or agent company ownership:
  • board users can access companies they belong to
  • instance admins can access all companies
  • agents can access only their own company
  • local trusted mode bypasses board membership checks for local development

​
Create Company

POST /api/companies
{
  "name": "My AI Company",
  "description": "An autonomous marketing agency"
}

​
Update Company

PATCH /api/companies/{companyId}
{
  "name": "Updated Name",
  "description": "Updated description",
  "budgetMonthlyCents": 100000,
  "logoAssetId": "b9f5e911-6de5-4cd0-8dc6-a55a13bc02f6"
}
Upload an image for a company icon and store it as that company’s logo. 
POST /api/companies/{companyId}/logo
Content-Type: multipart/form-data
Valid image content types:
  • image/png
  • image/jpeg
  • image/jpg
  • image/webp
  • image/gif
  • image/svg+xml
Company logo uploads use the normal Paperclip attachment size limit. Then set the company logo by PATCHing the returned assetId into logoAssetId.

​
Archive Company

POST /api/companies/{companyId}/archive
Archives a company. Archived companies are hidden from default listings.

​
Company Fields

FieldTypeDescription
idstringUnique identifier
namestringCompany name
descriptionstringCompany description
statusstringactive, paused, archived
logoAssetIdstringOptional asset id for the stored logo image
logoUrlstringOptional Paperclip asset content path for the stored logo image
budgetMonthlyCentsnumberMonthly budget limit
createdAtstringISO timestamp
updatedAtstringISO timestamp
Once a company exists, the rest of the control plane typically fans out from it:
  • agents and agent keys
  • issues, comments, documents, and attachments
  • projects and workspaces
  • goals and objectives
  • approvals and join requests
  • costs, finance events, and budgets
  • secrets and instance settings (board-only)