API reference

The Cairn API will let you read and write tasks, habits, goals, and notes from your own scripts. It's on the roadmap right after the persistence layer.

Authentication

Personal access tokens, scoped per workspace. Create from Settings → Connections.

Endpoints (planned)

GET    /v1/tasks
POST   /v1/tasks
PATCH  /v1/tasks/{id}
DELETE /v1/tasks/{id}

GET    /v1/habits
POST   /v1/habits/{id}/checkin

GET    /v1/goals
PATCH  /v1/goals/{id}/status

POST   /v1/inbox/capture

Webhooks

Subscribe to events: task.completed, habit.streak.broken, goal.at-risk. Useful for bridging into Notion, Slack, or your own automations.

SDKs

Official TypeScript SDK is planned. Until then, the REST API will be the only surface.

Rate limits

Free: 60 req/min. Pro: 600 req/min. Burst over for short windows.