API Endpoints

Detailed endpoint reference for The Corporation REST API.

All mutating operations go through the intent system — POST /v1/intents with an action and params. The API evaluates policies, executes the action, and returns a hash-bound receipt.

Entities

POST /v1/intents — Form entity

{
  "action": "form_entity",
  "params": {
    "entity_name": "Acme AI Inc",
    "entity_type": "c_corp",
    "jurisdiction": "DE"
  }
}

POST /v1/intents — Convert entity

{
  "action": "convert_entity",
  "params": {
    "entity_id": "ent_abc123",
    "target_type": "c_corp"
  }
}

POST /v1/intents — Dissolve entity

{
  "action": "dissolve_entity",
  "params": {
    "entity_id": "ent_abc123",
    "reason": "Business closure"
  }
}

GET /v1/entities

List all entities in the workspace.

Parameter	Description
type	Filter by entity type (llc, c_corp)
status	Filter by status (active, dissolved)

GET /v1/entities/:id

Get entity details including formation status, documents, and cap table.

Equity

POST /v1/intents — Issue equity

{
  "action": "issue_equity",
  "params": {
    "entity_id": "ent_abc123",
    "grant_type": "common",
    "shares": 5000000,
    "recipient_name": "Jane Smith"
  }
}

POST /v1/intents — Issue SAFE

{
  "action": "issue_safe",
  "params": {
    "entity_id": "ent_abc123",
    "investor_name": "Acme Fund LP",
    "principal_amount_cents": 50000000,
    "valuation_cap_cents": 1000000000,
    "safe_type": "post_money"
  }
}

POST /v1/intents — Transfer shares

{
  "action": "transfer_shares",
  "params": {
    "entity_id": "ent_abc123",
    "from_name": "Jane Smith",
    "to_name": "Bob Chen",
    "shares": 100000,
    "share_class": "common"
  }
}

POST /v1/intents — Calculate distribution

{
  "action": "calculate_distribution",
  "params": {
    "entity_id": "ent_abc123",
    "total_amount_cents": 10000000,
    "method": "pro_rata"
  }
}

GET /v1/entities/:id/cap-table

View the full cap table for an entity, including equity grants and SAFEs.

Documents

GET /v1/entities/:id/documents

List all documents for an entity.

POST /v1/intents — Sign document

{
  "action": "sign_document",
  "params": {
    "document_id": "doc_xyz789",
    "signer_name": "Jane Smith",
    "signer_role": "director"
  }
}

POST /v1/intents — Generate contract

{
  "action": "generate_contract",
  "params": {
    "entity_id": "ent_abc123",
    "template": "nda",
    "counterparty_name": "Acme Corp",
    "governing_law": "DE"
  }
}

Available templates: nda, contractor_agreement, offer_letter, consulting_agreement, advisor_agreement.

Financial

POST /v1/intents — Create invoice

{
  "action": "create_invoice",
  "params": {
    "entity_id": "ent_abc123",
    "client_name": "Client Co",
    "amount_cents": 500000,
    "description": "January consulting services",
    "due_days": 30
  }
}

POST /v1/intents — Run payroll

{
  "action": "run_payroll",
  "params": {
    "entity_id": "ent_abc123",
    "period": "2026-01",
    "pay_date": "2026-01-31"
  }
}

POST /v1/intents — Submit payment

{
  "action": "submit_payment",
  "params": {
    "entity_id": "ent_abc123",
    "recipient_name": "Vendor LLC",
    "amount_cents": 120000,
    "method": "ach",
    "memo": "Office supplies"
  }
}

POST /v1/intents — Open bank account

{
  "action": "open_bank_account",
  "params": {
    "entity_id": "ent_abc123"
  }
}

Auto-assembles the KYB package from formation documents.

POST /v1/intents — Classify contractor

{
  "action": "classify_contractor",
  "params": {
    "entity_id": "ent_abc123",
    "worker_name": "Alex Designer",
    "role_description": "UI/UX design work, 20 hrs/week, own equipment",
    "jurisdiction": "CA"
  }
}

Returns AB5 / economic-reality analysis with risk score.

POST /v1/intents — Reconcile ledger

{
  "action": "reconcile_ledger",
  "params": {
    "entity_id": "ent_abc123",
    "period": "2026-01"
  }
}

Governance

POST /v1/intents — Convene meeting

{
  "action": "convene_meeting",
  "params": {
    "entity_id": "ent_abc123",
    "meeting_type": "board",
    "title": "Q1 Board Meeting",
    "agenda_items": ["Approve equity plan", "Review financials"]
  }
}

POST /v1/intents — Cast vote

{
  "action": "cast_vote",
  "params": {
    "meeting_id": "mtg_def456",
    "agenda_item_index": 0,
    "voter_name": "Jane Smith",
    "decision": "approve"
  }
}

Decisions: approve, reject, abstain.

Tax & Compliance

POST /v1/intents — File tax document

{
  "action": "file_tax_document",
  "params": {
    "entity_id": "ent_abc123",
    "filing_type": "1099_nec",
    "tax_year": 2025,
    "recipient_name": "Alex Designer"
  }
}

Filing types: 1099_nec, k1, 941, w2, estimated.

POST /v1/intents — Track deadline

{
  "action": "track_deadline",
  "params": {
    "entity_id": "ent_abc123",
    "deadline_type": "annual_report",
    "jurisdiction": "DE"
  }
}

Agents

POST /v1/agents

Create a new agent.

{
  "name": "Invoice Processor",
  "system_prompt": "You process invoices for Acme AI Inc.",
  "model": "claude-sonnet-4-6",
  "entity_id": "ent_abc123"
}

GET /v1/agents

List all agents in the workspace.

POST /v1/agents/:id/messages

Send a message to an agent to trigger execution.

{
  "content": "Process all outstanding invoices for January"
}

PATCH /v1/agents/:id

Update agent configuration (status, name, prompt).

{
  "status": "paused"
}

POST /v1/agents/:id/skills

Add a composable skill to an agent.

{
  "skill": "invoicing"
}

Obligations

GET /v1/obligations

List all human-required obligations with urgency tiers.

Parameter	Description
tier	Filter by urgency tier (critical, high, medium, low)
status	Filter by status (pending, completed)

Contacts

POST /v1/contacts

Create a new contact.

{
  "name": "Jane Smith",
  "email": "[email protected]",
  "role": "founder"
}

GET /v1/contacts

List all contacts in the workspace.

GET /v1/contacts/:id/profile

Get full contact profile.

Webhooks

POST /v1/inbound/webhook/:agent_id

Trigger an agent execution via external webhook.

POST /v1/inbound/email/:agent_id

Email-to-agent bridge endpoint. Forward emails to trigger agent actions.

Receipts

GET /v1/receipts/:receipt_id

Retrieve an immutable, hash-bound receipt for any executed action. Every successful intent produces a receipt that serves as the audit trail.