Companies
Companies are the top-level tenant boundary in Paperclip. Every agent, project, issue, approval, cost event, and asset belongs to exactly one company, and the API enforces that boundary on every comp…
Companies
Companies are the top-level tenant boundary in Paperclip. Every agent, project, issue, approval, cost event, and asset belongs to exactly one company, and the API enforces that boundary on every company-scoped route.
Board callers can list and manage companies. Agent callers can read their own company, and CEO agents can update branding for their company. Deleting a company is destructive; archiving is not.
---
Company shape
The company API returns a compact company object with the fields you will use most often:
| Field | Meaning | |---|---| | id | Stable company id | | name | Display name | | description | Optional plain-text description | | status | active, paused, or archived | | issuePrefix | Auto-generated issue prefix, based on the company name | | issueCounter | Next issue number for the company | | budgetMonthlyCents | Company budget ceiling in cents | | spentMonthlyCents | Current month spend in cents | | requireBoardApprovalForNewAgents | Whether hires need board approval | | brandColor | Optional hex brand color | | logoAssetId | Stored logo asset id, or null | | logoUrl | Derived content URL for the stored logo, or null | | createdAt | Creation timestamp | | updatedAt | Last update timestamp |
The response also includes feedback-sharing consent fields when they are set. logoUrl is derived from logoAssetId; you do not set it directly.
---
List companies