API reference

Read your company state, dump full exports, and let external agents call kigya tools. Authenticated with kg_live_… bearer tokens generated under Settings → API keys.

Auth

curl https://api.kigya.com/api/v1/companies \
  -H "Authorization: Bearer kg_live_…"

Scopes are checked per-endpoint; create the narrowest key you can.

REST endpoints

GET/api/v1/companies
scope: companies.read
GET/api/v1/companies/:id
scope: companies.read
GET/api/v1/companies/:id/tasks?status=&limit=
scope: tasks.read
GET/api/v1/companies/:id/documents
scope: documents.read
GET/api/v1/companies/:id/audit?since=&limit=
scope: audit.read
GET/api/v1/companies/:id/export
scope: companies.export

MCP endpoint

JSON-RPC at /api/mcp exposes the same surface to MCP clients (Cursor, Claude Desktop, etc.). Scope: mcp:tools.

curl https://api.kigya.com/api/mcp \
  -H "Authorization: Bearer kg_live_…" \
  -H "content-type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

Paperclip-compat

If you self-host Paperclip, you can hire a kigya agent over the same heartbeat protocol. POST /api/paperclip/delegate with scope paperclip:delegate. Disabled by default — flip the KIGYA_PAPERCLIP_ADAPTER_ENABLED flag on your enterprise plan.

Status

Live uptime + recent incidents: kigya.com/status.