REST API

The Corporation exposes a REST API for integrations, dashboards, and programmatic access to corporate operations.

Base URL

https://api.thecorporation.ai/v1

Authentication

All requests require a workspace API key in the Authorization header:

curl -H "Authorization: Bearer $CORP_API_KEY" \
     https://api.thecorporation.ai/v1/entities

Core resources

Resource	Description
/v1/entities	Legal entities (LLCs, corporations) — form, convert, dissolve
/v1/entities/:id/cap-table	Equity ownership, grants, and SAFEs
/v1/entities/:id/documents	Formation docs, contracts, tax filings
/v1/contacts	People and organizations
/v1/obligations	Human-required actions with urgency tiers
/v1/agents	Autonomous agents
/v1/intents	Intent creation, evaluation, and execution
/v1/receipts	Immutable, hash-bound audit trail

Financial resources

Resource	Description
/v1/invoices	Create and manage invoices
/v1/payroll/runs	Run payroll cycles
/v1/payments	ACH, wire, and check payments
/v1/share-transfers	Transfer shares between holders
/v1/treasury/chart-of-accounts	Chart of accounts and ledger
/v1/ledger/reconcile	Ledger reconciliation
/v1/contractors/classify	Employee vs. contractor analysis
/v1/valuations	409A valuations

Governance resources

Resource	Description
/v1/governance-bodies	Board and committee definitions
/v1/seats	Board and committee seats
/v1/meetings	Meetings — convene, vote, resolve
/v1/deadlines	Compliance and filing deadlines
/v1/tax/filings	Tax document generation

Execution model

All mutating operations go through the intent system:

POST /v1/intents
{
  "action": "form_entity",
  "params": { "entity_name": "Acme AI LLC", "entity_type": "llc", "jurisdiction": "DE" }
}

The API evaluates policies, executes the action, and returns a hash-bound receipt.

Agent API

Agents have dedicated endpoints for inbound triggers:

Endpoint	Description
POST /v1/agents	Create a new agent
POST /v1/agents/:id/messages	Send a message to an agent
POST /v1/inbound/webhook/:agent_id	External webhook trigger
POST /v1/inbound/email/:agent_id	Email-to-agent bridge

Endpoints

See the Endpoints reference for the complete list.