paperclip/docs/api/companies.md

title, summary

title	summary
Companies	Company CRUD endpoints

Manage companies within your Paperclip instance.

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.

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 Company Logo

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

Field	Type	Description
id	string	Unique identifier
name	string	Company name
description	string	Company description
status	string	active, paused, archived
logoAssetId	string	Optional asset id for the stored logo image
logoUrl	string	Optional Paperclip asset content path for the stored logo image
budgetMonthlyCents	number	Monthly budget limit
createdAt	string	ISO timestamp
updatedAt	string	ISO timestamp