CCoult Docs
PricingGet an API key

REST API

Authenticate with Authorization: Bearer <access_token>. Base URL https://coult.gravitilabs.com/api.

Auth

POST/v1/auth/signup
POST/v1/auth/login
POST/v1/auth/refresh
POST/v1/auth/logout

Todos

GET/v1/todos
POST/v1/todos
GET/v1/todos/:id
PATCH/v1/todos/:id
DELETE/v1/todos/:id
POST/v1/todos/:id/complete
POST/v1/todos/:id/reopen
POST/v1/todos/:id/duplicate
POST/v1/todos/:id/snippets
POST/v1/todos/:id/reminders
POST/v1/todos/:id/git-links

Smart views

GET/v1/views/today
GET/v1/views/inbox
GET/v1/views/upcoming
GET/v1/views/starred
GET/v1/views/recurring
GET/v1/views/completed
GET/v1/views/trash
GET/v1/views/dashboard
GET/v1/views/calendar
GET/v1/views/heatmap

Folders & tags

GET/v1/folders
POST/v1/folders
PATCH/v1/folders/:id
DELETE/v1/folders/:id
GET/v1/tags
POST/v1/tags

Search

GET/v1/search?q=&mode=text|regex|code
GET/v1/search/saved
POST/v1/search/saved

Bulk + AI + Realtime

POST/v1/bulk
POST/v1/ai/breakdown
POST/v1/ai/estimate
POST/v1/ai/prioritize
POST/v1/ai/plan-day
POST/v1/ai/explain-snippet
GET/v1/ai/quota
GET/v1/events?token=...

Intelligence

GET/v1/intelligence/standup
GET/v1/intelligence/shipped-this-week
GET/v1/intelligence/sprint
GET/v1/intelligence/branch?title=&priority=&tags=

Billing & automations

GET/v1/billing/plans
GET/v1/billing/subscription
GET/v1/billing/usage
POST/v1/billing/trial
POST/v1/billing/change-plan
POST/v1/billing/cancel
POST/v1/billing/resume
GET/v1/automations
POST/v1/automations

Integrations

GET/v1/integrations
GET/v1/integrations/github/start
GET/v1/integrations/github/callback
GET/v1/integrations/github/repos
DELETE/v1/integrations/:provider

Import & export

POST/v1/import/json
POST/v1/import/todoist
GET/v1/export/json
GET/v1/export/csv
GET/v1/export/markdown

Quickstart

# 1. Authenticate
curl -s -X POST $API/v1/auth/login \
  -H 'content-type: application/json' \
  -d '{"email":"you@example.com","password":"…"}' | jq -r '.tokens.accessToken' > token.txt

# 2. Use the token
TOKEN=$(cat token.txt)
curl -s $API/v1/views/today -H "Authorization: Bearer $TOKEN" | jq

# 3. Create a todo
curl -s -X POST $API/v1/todos \
  -H "Authorization: Bearer $TOKEN" \
  -H 'content-type: application/json' \
  -d '{"title":"Ship Coult docs","priority":"p1","tagNames":["docs"]}'