Caliph

Caliph API

Use your tasks, Lists, and blocked sites from other apps and scripts, with one key.

1. Create a key in Caliph, under API keys.

   Copy it straight away; it’s shown only once.

2. Send it with each request. For example, add a task:

   curl https://api.caliphapp.com/v1/tasks \
     -H "Authorization: Bearer caliph_sk_…" \
     -H "content-type: application/json" \
     -d '{"title":"Buy milk"}'

What you can do

• GET/v1/tasksYour open tasks, or ?status=all
• POST/v1/tasksAdd a task · {"title": "…"}
• GET/v1/tasks/{id}One task
• PATCH/v1/tasks/{id}Change or complete it · {"done": true}
• DELETE/v1/tasks/{id}Remove it and its subtasks
• GET/v1/listsYour Lists
• POST/v1/listsAdd a List · {"name": "…"}
• GET/v1/sitesYour blocked sites
• POST/v1/sitesBlock a site · {"domain": "youtube.com"}
• DELETE/v1/sites/{domain}Unblock it
• GET/v1/settingsYour blocking settings
• PATCH/v1/settingsChange them · {"allow_minutes": 15}
• GET/v1/meYour account

Good to know

• Keep your key private. If it leaks, revoke it under API keys; it stops working at once.
• Errors come back as {"error": "…"}, in plain words.

Questions? [email protected]