Files
paperclip/docs/api/companies.md

1.1 KiB

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
}

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
budgetMonthlyCents number Monthly budget limit
createdAt string ISO timestamp
updatedAt string ISO timestamp