PaperClipAI/docs/api/companies.md at 98df214917bc8f8a70b63b58105a1deea7cd73b0

0 Fork 0

mirror of https://github.com/paperclipai/paperclip.git synced 2026-10-26 10:26:26 +01:00

Files

T

Harold KimandPaperclip 98df214917 fix: fail closed on unusable Codex auth during sandbox auth merge

When reusing a Codex sandbox, the workspace-restore step now performs
an auth-merge check before adopting the sandbox's auth.json. The merge
fails closed when:

- host or sandbox Codex auth is unusable (missing token or account)
- the subscription payload shapes differ between host and sandbox
- subscription account identities do not match

Additional hardening: node absence on PATH during the embedded decision
script now exits non-zero instead of silently falling through. Co-change
comments link parseAuth (the embedded script) to hasUsableAuthPayload
(codex-home.ts) so a future auth-format change cannot silently diverge
between the two implementations.

Co-Authored-By: Paperclip <noreply@paperclip.ing>

2026-07-09 10:08:57 +00:00

1.8 KiB

Raw Blame History

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

1.8 KiB Raw Blame History Unescape Escape