Skip to content

API and agents

Everything the app does goes through the same API. Scripts use a personal token; Claude and other MCP clients connect with a browser sign-in.

API v1 only grows. Once a route or a response field is documented here it is never removed or renamed; a breaking change would be a new /api/v2.

Connect Claude

Run this, then sign in and choose what the agent may do:

claude mcp add --transport http darth-tasks https://mcp.darthtasks.com

Token scopes

read
Reads everything the token's limit allows. For briefs, dashboards and reports.
capture
Adds tasks to the Inbox and nothing else. For shortcuts, forms and mail rules.
write
Changes anything inside its limit. With approval on, its changes wait as a change set you apply or reject; one undo reverts a whole set.

Sync API for native apps

What a native app needs to stay in step with the account: one snapshot, then changes, and every write as a command.

Snapshot

On first launch, page through GET /api/v1/sync/snapshot until cursor is null. Keep the returned rev: it is where changes continue from.

GET /api/v1/sync/snapshot?cursor=

{
  "rows": [
    {
      "entity": "task",
      "id": "01J…",
      "rev": 812,
      "row": {
        "title": "Call the dentist",
        "state": "inbox"
      }
    }
  ],
  "rev": 812,
  "cursor": "task:01J…"
}

Changes

Then ask GET /api/v1/sync/changes?since=<rev> (or listen on the /api/v1/sync WebSocket). A deleted row arrives with its deletedAt while it is in Trash. When since is older than the account keeps, the answer is 410 resync_required: take a fresh snapshot.

GET /api/v1/sync/changes?since=812

{
  "changes": [
    {
      "entity": "task",
      "id": "01J…",
      "rev": 813,
      "row": {
        "title": "Call the dentist",
        "state": "next"
      }
    },
    {
      "entity": "task",
      "id": "01K…",
      "rev": 814,
      "row": {
        "deletedAt": 1795400000000
      }
    }
  ],
  "rev": 814,
  "more": false
}
GET https://darthtasks.com/api/v1/sync
Authorization: Bearer <session token>

{}

Commands

Every write is a command with an op_id you generate. Send up to 100 to POST /api/v1/commands; each gets its own result, applied or rejected with a code and the current row. Sending the same op_id again returns the first result, so retrying after a lost connection is safe.

POST /api/v1/commands

{
  "commands": [
    {
      "op_id": "01J…",
      "type": "task.create",
      "input": {
        "title": "Buy milk"
      }
    }
  ]
}

{
  "results": [
    {
      "op_id": "01J…",
      "status": "applied",
      "rev": 14
    }
  ]
}

Bearer sessions

A native app signs in with Clerk and sends the Clerk session token as Authorization: Bearer <token>. It is the Owner's session, so app-only routes are open to it; agent tokens (dt_…) are not.

Versions and /meta

Send X-Client: <platform>/<version> on every request. GET /api/v1/meta returns the API version, the schema version and the minimum client version per platform; an app older than its minimum gets 426 with the version to update to.

GET /api/v1/meta

{
  "apiVersion": "1",
  "schemaVersion": 3,
  "minClientVersions": {
    "ios": "1.0.0",
    "android": "1.0.0",
    "macos": "1.0.0"
  }
}

Additive-only rule

API v1 only grows. A documented route or response field is never removed or renamed; a breaking change would be a new /api/v2. Ignore fields you do not know.

Routes

RoutesAuthToken scope
GET /api/v1/meta

API version, schema version and the minimum client version per platform.

Example
GET /api/v1/meta

{
  "apiVersion": "1",
  "schemaVersion": 3,
  "minClientVersions": {
    "ios": "1.0.0",
    "android": "1.0.0",
    "macos": "1.0.0"
  }
}
none
GET /api/v1/tasks

List tasks. `view` = inbox (default), all or done; `state` filters by list; `availableOn=YYYY-MM-DD` hides tasks whose Start is later.

Example
GET /api/v1/tasks

{
  "tasks": [
    {
      "id": "01J…",
      "title": "Buy milk",
      "state": "inbox",
      "source": "quick_add",
      "rev": 12
    }
  ]
}
session or tokenread
POST /api/v1/tasks

Create a task. Send `Idempotency-Key` to make retries safe. A token with approval on gets 202 and a change set.

Example
POST /api/v1/tasks

{
  "title": "Call the bank"
}

{
  "task": {
    "id": "01J…",
    "title": "Call the bank"
  },
  "rev": 13
}
session or tokencapture
GET /api/v1/tasks/:id

One task.

Example
GET https://darthtasks.com/api/v1/tasks/{id}
Authorization: Bearer dt_…

{
  "task": "…"
}
session or tokenread
PATCH /api/v1/tasks/:id

Change the named fields of a task. `blockedBy` (M17) replaces the list of tasks that must be done first, across projects; a task blocked by itself or a loop through any chain is 422 (`dependency_self`, `dependency_cycle`).

Example
PATCH https://darthtasks.com/api/v1/tasks/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/tasks/:id

Move a task to Trash (kept 30 days).

Example
DELETE https://darthtasks.com/api/v1/tasks/{id}
Authorization: Bearer dt_…

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/complete

Complete a task.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/complete
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/reopen

Reopen a completed task.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/reopen
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/restore

Restore a task from Trash.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/move

Reorder: `before` and `after` are the neighbour ids after the move.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/skip

Move a repeating task to its next occurrence without completing it.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/skip
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/capture/parse

Preview what quick add would save from natural language: title, dates, home, tags, estimate, priority and the tokens with positions.

Example
POST /api/v1/capture/parse

{
  "text": "call dentist tomorrow 9am @phone ~15m"
}

{
  "title": "call dentist",
  "plannedDate": "2026-11-23",
  "plannedTime": "09:00",
  "tags": [
    "phone"
  ],
  "estimateMin": 15
}
session or tokenread
POST /api/v1/inbox/:id/process

One GTD decision: `decision` = do, next, waiting (needs `person`), schedule (needs `plannedDate`), project (needs `nextAction` or `decideLater`), someday, reference, trash.

Example
POST https://darthtasks.com/api/v1/inbox/{id}/process
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…"
}
session or tokenwrite
GET /api/v1/trash

Items deleted in the last 30 days, newest first, from every content entity: `entity`, `id`, `deletedAt`, `title` and the `row`. After 30 days they are removed for good. A limited token sees only items inside its limit.

Example
GET https://darthtasks.com/api/v1/trash
Authorization: Bearer dt_…

{
  "items": "…"
}
session or tokenread
POST /api/v1/trash/:entity/:id/restore

Put a trashed item back (M18: every content entity: task, project, area, heading, tag, block, product, routine, backlog_item, release, key_number, request, bet, list, list_item, milestone, template, perspective, week_outcome, reminder, attachment). `item` carries the entity and the row; `task` is set for a task.

Example
POST https://darthtasks.com/api/v1/trash/{entity}/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…",
  "item": "…"
}
session or tokenwrite
GET /api/v1/activity

Every change with before and after, newest first. `filter` = all, you, ai, agents, deletions; `projectId` keeps only that project's events (its tasks, headings, lists, milestones, reference and files).

Example
GET https://darthtasks.com/api/v1/activity
Authorization: Bearer dt_…

{
  "events": "…",
  "titles": "…",
  "next": "…"
}
session or tokenread
GET /api/v1/activity/export

Download the activity log as JSON, one object per event, honouring `filter`.

Example
GET https://darthtasks.com/api/v1/activity/export
Authorization: Bearer dt_…

{}
session or tokenread
POST /api/v1/activity/:seq/undo

Undo one change. 409 `conflict` names the fields that changed since; send `force: true` to apply.

Example
POST https://darthtasks.com/api/v1/activity/{seq}/undo
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…"
}
session or tokenwrite
POST /api/v1/commands

Up to 100 commands with `op_id`s, applied in order; one result per command.

Example
POST /api/v1/commands

{
  "commands": [
    {
      "op_id": "01J…",
      "type": "task.create",
      "input": {
        "title": "Buy milk"
      }
    }
  ]
}

{
  "results": [
    {
      "op_id": "01J…",
      "status": "applied",
      "rev": 14
    }
  ]
}
session or tokenwrite
GET /api/v1/change-sets

Change sets waiting for approval (`status=all` for every set).

Example
GET https://darthtasks.com/api/v1/change-sets
Authorization: Bearer <session token>

{
  "changeSets": "…"
}
app session
POST /api/v1/change-sets

Propose several changes; the Owner applies or rejects them.

Example
POST https://darthtasks.com/api/v1/change-sets
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "changeSet": "…",
  "rev": "…",
  "result": "…"
}
session or tokenwrite
POST /api/v1/change-sets/:id/apply

Apply the selected changes (indexes) in one step.

Example
POST https://darthtasks.com/api/v1/change-sets/{id}/apply
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…"
}
app session
POST /api/v1/change-sets/:id/reject

Reject a proposed set; nothing changes.

Example
POST https://darthtasks.com/api/v1/change-sets/{id}/reject
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…"
}
app session
POST /api/v1/change-sets/:id/undo

Undo every change of an applied set.

Example
POST https://darthtasks.com/api/v1/change-sets/{id}/undo
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…"
}
app session
GET /api/v1/sync/snapshot

The whole account in pages (`cursor`), with the `rev` to continue from.

Example
GET /api/v1/sync/snapshot?cursor=

{
  "rows": [
    {
      "entity": "task",
      "id": "01J…",
      "rev": 812,
      "row": {
        "title": "Call the dentist",
        "state": "inbox"
      }
    }
  ],
  "rev": 812,
  "cursor": "task:01J…"
}
app session
GET /api/v1/sync/changes

Rows changed after `since`, in rev order; 410 `resync_required` when `since` is too old.

Example
GET /api/v1/sync/changes?since=812

{
  "changes": [
    {
      "entity": "task",
      "id": "01J…",
      "rev": 813,
      "row": {
        "title": "Call the dentist",
        "state": "next"
      }
    },
    {
      "entity": "task",
      "id": "01K…",
      "rev": 814,
      "row": {
        "deletedAt": 1795400000000
      }
    }
  ],
  "rev": 814,
  "more": false
}
app session
GET /api/v1/sync

WebSocket: live changes in the /sync/changes format.

Example
GET https://darthtasks.com/api/v1/sync
Authorization: Bearer <session token>

{}
app session
GET /api/v1/tokens

Agent tokens and OAuth grants (never the secret).

Example
GET https://darthtasks.com/api/v1/tokens
Authorization: Bearer <session token>

{
  "tokens": "…"
}
app session
POST /api/v1/tokens

Create a token; the secret is returned once.

Example
POST https://darthtasks.com/api/v1/tokens
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "token": "…",
  "secret": "…"
}
app session
DELETE /api/v1/tokens/:id

Revoke a token or grant (effective within a minute).

Example
DELETE https://darthtasks.com/api/v1/tokens/{id}
Authorization: Bearer <session token>

{
  "ok": "…"
}
app session
POST /api/v1/ai/clarify

AI suggestion for one Inbox item (Pro; Lifetime with its own key). 402 on Free, 429 `fair_use` at the weekly limit.

Example
POST https://darthtasks.com/api/v1/ai/clarify
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "suggestion": "…",
  "fixture": "…"
}
app session
POST /api/v1/ai/breakdown

Three to five next actions for a project (Pro).

Example
POST https://darthtasks.com/api/v1/ai/breakdown
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "actions": "…",
  "fixture": "…"
}
app session
POST /api/v1/ai/split

Split an email or note into separate items to confirm (Pro).

Example
POST https://darthtasks.com/api/v1/ai/split
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "items": "…",
  "fixture": "…"
}
app session
GET /api/v1/ai/usage

This week's AI use against the fair-use limit.

Example
GET https://darthtasks.com/api/v1/ai/usage
Authorization: Bearer <session token>

{
  "plan": "…",
  "week": "…",
  "used": "…",
  "limit": "…",
  "reviewPreps": "…",
  "reviewLimit": "…",
  "warning": "…",
  "hasOwnKey": "…"
}
app session
POST /api/v1/ai/key

Lifetime: test and save your own Anthropic key (stored encrypted, never returned).

Example
POST https://darthtasks.com/api/v1/ai/key
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "ok": "…"
}
app session
DELETE /api/v1/ai/key

Lifetime: remove your own AI key.

Example
DELETE https://darthtasks.com/api/v1/ai/key
Authorization: Bearer <session token>

{
  "ok": "…"
}
app session
POST /api/v1/capture/voice

Audio (up to 2 minutes) → transcript and the item(s) to confirm. The audio is not stored.

Example
POST https://darthtasks.com/api/v1/capture/voice
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "transcript": "…",
  "items": "…"
}
app session
GET /api/v1/account

Your account: email, name, plan and private capture address.

Example
GET https://darthtasks.com/api/v1/account
Authorization: Bearer <session token>

{
  "email": "…",
  "name": "…",
  "plan": "…",
  "emailInAddress": "…"
}
app session
POST /api/v1/account/email-in/regenerate

New private capture address; the old one stops working.

Example
POST https://darthtasks.com/api/v1/account/email-in/regenerate
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "emailInAddress": "…"
}
app session
GET /api/v1/emails/:id

The email behind an item.

Example
GET https://darthtasks.com/api/v1/emails/{id}
Authorization: Bearer dt_…

{
  "email": "…",
  "text": "…",
  "hasHtml": "…",
  "attachments": "…"
}
session or tokenread
GET /api/v1/settings

The account's settings (time zone, review day, capacity, theme and accent, advanced switches, first run) and `checklist`: the Today checklist items done (capture, clarify, focus, review).

Example
GET https://darthtasks.com/api/v1/settings
Authorization: Bearer <session token>

{
  "settings": "…",
  "checklist": "…"
}
app session
PATCH /api/v1/settings

Change settings: `tz` (an IANA time zone), `workingWeek` (7 windows, Sunday first, null for a day off), `capacity`, `reviewDay`, `reviewNudge`, `notifications`, `advanced`, `theme` (system, light, dark), `accent` (indigo, teal, orange, violet), `checklist` ({dismissed}), `firstRun` (done, skipped).

Example
PATCH https://darthtasks.com/api/v1/settings
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "settings": "…"
}
app session
GET /api/v1/billing/plan

The plan as Settings shows it.

Example
GET https://darthtasks.com/api/v1/billing/plan
Authorization: Bearer <session token>

{
  "plan": "…",
  "trialEndsAt": "…",
  "trialUsed": "…",
  "managedIn": "…",
  "subscription": "…",
  "canManage": "…",
  "lifetime": "…",
  "country": "…"
}
app session
GET /api/v1/billing/seats

Founding Lifetime seats left (cached 60 s).

Example
GET https://darthtasks.com/api/v1/billing/seats

{
  "seatsLeft": "…",
  "open": "…"
}
none
POST /api/v1/billing/checkout

Stripe Checkout for Pro (month or year) or Founding Lifetime.

Example
POST https://darthtasks.com/api/v1/billing/checkout
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "url": "…"
}
app session
POST /api/v1/billing/portal

Stripe Customer Portal.

Example
POST https://darthtasks.com/api/v1/billing/portal
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "url": "…"
}
app session
POST /api/v1/billing/cancel

Cancel at period end.

Example
POST https://darthtasks.com/api/v1/billing/cancel
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "plan": "…",
  "subscription": "…"
}
app session
POST /api/v1/billing/resume

Undo a cancel before the period ends.

Example
POST https://darthtasks.com/api/v1/billing/resume
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "plan": "…",
  "subscription": "…"
}
app session
POST /api/v1/billing/trial

Start the 14-day Pro trial (once).

Example
POST https://darthtasks.com/api/v1/billing/trial
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "plan": "…",
  "trialEndsAt": "…"
}
app session
GET /api/v1/areas

List areas in order; `offered` holds the four starter areas while there are none.

Example
GET https://darthtasks.com/api/v1/areas
Authorization: Bearer dt_…

{
  "areas": "…",
  "offered": "…"
}
session or tokenread
GET /api/v1/areas/:id

One area with its projects (with progress) and loose tasks.

Example
GET https://darthtasks.com/api/v1/areas/{id}
Authorization: Bearer dt_…

{
  "area": "…",
  "projects": "…",
  "tasks": "…"
}
session or tokenread
POST /api/v1/areas

Create an area.

Example
POST https://darthtasks.com/api/v1/areas
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "area": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/areas/:id

Change only the named fields of an area.

Example
PATCH https://darthtasks.com/api/v1/areas/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "area": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/areas/:id

Move an area to Trash (with what it contains).

Example
DELETE https://darthtasks.com/api/v1/areas/{id}
Authorization: Bearer dt_…

{
  "area": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/areas/:id/restore

Restore an area from Trash.

Example
POST https://darthtasks.com/api/v1/areas/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "area": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/areas/:id/move

Reorder an area between two neighbours (`before`, `after`).

Example
POST https://darthtasks.com/api/v1/areas/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "area": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/projects

List projects with progress; `?areaId=<id>` or `?areaId=none` for unfiled projects.

Example
GET https://darthtasks.com/api/v1/projects
Authorization: Bearer dt_…

{
  "projects": "…"
}
session or tokenread
GET /api/v1/projects/:id

One project with notes, links, progress, headings and tasks.

Example
GET https://darthtasks.com/api/v1/projects/{id}
Authorization: Bearer dt_…

{
  "project": "…",
  "headings": "…",
  "tasks": "…"
}
session or tokenread
POST /api/v1/projects

Create a project.

Example
POST https://darthtasks.com/api/v1/projects
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/projects/:id

Change only the named fields of a project.

Example
PATCH https://darthtasks.com/api/v1/projects/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/projects/:id

Move a project to Trash (with what it contains).

Example
DELETE https://darthtasks.com/api/v1/projects/{id}
Authorization: Bearer dt_…

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/projects/:id/restore

Restore a project from Trash.

Example
POST https://darthtasks.com/api/v1/projects/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/projects/:id/move

Reorder a project between two neighbours (`before`, `after`).

Example
POST https://darthtasks.com/api/v1/projects/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/headings

Headings of one project (`?projectId=`), in order.

Example
GET https://darthtasks.com/api/v1/headings
Authorization: Bearer dt_…

{
  "headings": "…"
}
session or tokenread
POST /api/v1/headings

Create a heading.

Example
POST https://darthtasks.com/api/v1/headings
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "heading": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/headings/:id

Change only the named fields of a heading.

Example
PATCH https://darthtasks.com/api/v1/headings/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "heading": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/headings/:id

Move a heading to Trash (with what it contains).

Example
DELETE https://darthtasks.com/api/v1/headings/{id}
Authorization: Bearer dt_…

{
  "heading": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/headings/:id/restore

Restore a heading from Trash.

Example
POST https://darthtasks.com/api/v1/headings/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "heading": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/headings/:id/move

Reorder a heading between two neighbours (`before`, `after`).

Example
POST https://darthtasks.com/api/v1/headings/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "heading": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/tags

List tags by name.

Example
GET https://darthtasks.com/api/v1/tags
Authorization: Bearer dt_…

{
  "tags": "…"
}
session or tokenread
PATCH /api/v1/tags/:id

Rename a tag or set its kind (person, tool, energy, location).

Example
PATCH https://darthtasks.com/api/v1/tags/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "tag": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/tags/:id

Delete a tag; tasks lose it.

Example
DELETE https://darthtasks.com/api/v1/tags/{id}
Authorization: Bearer dt_…

{
  "tag": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tags/:id/restore

Restore a deleted tag.

Example
POST https://darthtasks.com/api/v1/tags/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "tag": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/views/next

Next actions; repeat `?tag=` to keep tasks that carry every tag given. Advanced filters (M17), each applied only while its switch is on: `maxMinutes` (estimate at most N minutes) and `energy` (an energy tag) under energy and time, `location` (a location tag) under locations. With dependencies on, a task whose blocker is still open is left out.

Example
GET https://darthtasks.com/api/v1/views/next
Authorization: Bearer dt_…

{
  "tasks": "…"
}
session or tokenread
GET /api/v1/views/waiting

Waiting for, by follow-up date; `followUpDue` marks rows due today or earlier.

Example
GET https://darthtasks.com/api/v1/views/waiting
Authorization: Bearer dt_…

{
  "tasks": "…"
}
session or tokenread
GET /api/v1/views/someday

Someday tasks and someday projects.

Example
GET https://darthtasks.com/api/v1/views/someday
Authorization: Bearer dt_…

{
  "tasks": "…",
  "projects": "…"
}
session or tokenread
GET /api/v1/views/nav

Sidebar counts (inbox, next, waiting, someday), areas and open projects.

Example
GET https://darthtasks.com/api/v1/views/nav
Authorization: Bearer dt_…

{
  "counts": "…",
  "areas": "…",
  "projects": "…"
}
session or tokenread
GET /api/v1/search

Search tasks and projects (`?q=`); a task hit carries its project's id and name.

Example
GET https://darthtasks.com/api/v1/search
Authorization: Bearer dt_…

{
  "tasks": "…",
  "projects": "…"
}
session or tokenread
GET /api/v1/views/today

Today: `focus` (up to 3), `planned`, `due`, `followUps`, `more` (from Next) and today's `blocks`; `routinesDue`, `drifting` (M10) and `pinnedLists` (lists pinned to today, M14).

Example
GET https://darthtasks.com/api/v1/views/today
Authorization: Bearer dt_…

{
  "date": "…",
  "focus": "…",
  "planned": "…",
  "due": "…",
  "followUps": "…",
  "more": "…",
  "blocks": "…",
  "routinesDue": "…",
  "drifting": "…",
  "pinnedLists": "…",
  "events": "…"
}
session or tokenread
GET /api/v1/views/upcoming

The next 14 days from today, each with the tasks planned (or, with no Planned, due) that day, its calendar `events` and its `pinnedLists` (M14).

Example
GET https://darthtasks.com/api/v1/views/upcoming
Authorization: Bearer dt_…

{
  "days": "…"
}
session or tokenread
GET /api/v1/views/logbook

Completed tasks grouped by completion day in the account time zone, newest first; `?q=` searches; `?before=` pages.

Example
GET https://darthtasks.com/api/v1/views/logbook
Authorization: Bearer dt_…

{
  "days": "…",
  "more": "…"
}
session or tokenread
GET /api/v1/capacity

Free, planned and buffer minutes per day for `?from=&to=` (default today); `over` when planned is greater than free.

Example
GET https://darthtasks.com/api/v1/capacity
Authorization: Bearer dt_…

{
  "days": "…"
}
session or tokenread
GET /api/v1/blocks

Time blocks for `?from=&to=` (default today).

Example
GET https://darthtasks.com/api/v1/blocks
Authorization: Bearer dt_…

{
  "blocks": "…"
}
session or tokenread
GET /api/v1/blocks/:id

One time block.

Example
GET https://darthtasks.com/api/v1/blocks/{id}
Authorization: Bearer dt_…

{
  "block": "…"
}
session or tokenread
POST /api/v1/blocks

Place a task (or a title) on the day: `date`, `start` (HH:MM), `minutes` (default the task's estimate, or 30).

Example
POST https://darthtasks.com/api/v1/blocks
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/blocks/:id

Move (`date`, `start`) or resize (`minutes`) a block.

Example
PATCH https://darthtasks.com/api/v1/blocks/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/blocks/:id

Remove a block.

Example
DELETE https://darthtasks.com/api/v1/blocks/{id}
Authorization: Bearer dt_…

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/blocks/:id/restore

Restore a removed block.

Example
POST https://darthtasks.com/api/v1/blocks/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/tasks/:id/focus

Make a task a focus item for today (or `date`); a fourth for one day is 409 `focus_full` with the current `ids` unless `replace` names one.

Example
POST https://darthtasks.com/api/v1/tasks/{id}/focus
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/tasks/:id/focus

Clear a task's focus.

Example
DELETE https://darthtasks.com/api/v1/tasks/{id}/focus
Authorization: Bearer dt_…

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/calendar

Google Calendar status: `connected`, the label, the calendars and the `chosen` ones.

Example
GET https://darthtasks.com/api/v1/calendar
Authorization: Bearer <session token>

{
  "connected": "…",
  "label": "…",
  "calendars": "…",
  "chosen": "…"
}
app session
GET /api/v1/calendar/connect

Start connecting Google Calendar (a redirect to Google's consent page).

Example
GET https://darthtasks.com/api/v1/calendar/connect
Authorization: Bearer <session token>

{}
app session
GET /api/v1/calendar/callback

Google's OAuth callback; a wrong or missing `state` is 400.

Example
GET https://darthtasks.com/api/v1/calendar/callback
Authorization: Bearer <session token>

{}
app session
PATCH /api/v1/calendar

Choose which calendars to read (`calendars`: ids).

Example
PATCH https://darthtasks.com/api/v1/calendar
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "chosen": "…"
}
app session
DELETE /api/v1/calendar

Disconnect: revoke at Google, stop channels, delete tokens and cached events.

Example
DELETE https://darthtasks.com/api/v1/calendar
Authorization: Bearer <session token>

{
  "connected": "…"
}
app session
POST /api/v1/blocks/suggest

Suggest a block for a task (`taskId`, `date`) in free time sized by its estimate; `status` is `suggested` and nothing goes to Google.

Example
POST https://darthtasks.com/api/v1/blocks/suggest
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/blocks/:id/place

Make a suggested block real; it is then added to the Darth Tasks calendar.

Example
POST https://darthtasks.com/api/v1/blocks/{id}/place
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "block": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products

List products.

Example
GET https://darthtasks.com/api/v1/products
Authorization: Bearer dt_…

{
  "products": "…"
}
session or tokenread
GET /api/v1/products/:id

A product with its projects (next action, progress), loose tasks, routines, key numbers and tab counts; `product.lastActivityAt` and `product.readOnly` included.

Example
GET https://darthtasks.com/api/v1/products/{id}
Authorization: Bearer dt_…

{
  "product": "…",
  "projects": "…",
  "tasks": "…",
  "routines": "…",
  "numbers": "…",
  "counts": "…"
}
session or tokenread
POST /api/v1/products

Create a product. On Free a second active product is 402 `product_limit`.

Example
POST https://darthtasks.com/api/v1/products
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "product": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/products/:id

Change a product. A read-only product (Free after a downgrade) is 402 `product_read_only`.

Example
PATCH https://darthtasks.com/api/v1/products/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "product": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/products/:id

Move a product to Trash.

Example
DELETE https://darthtasks.com/api/v1/products/{id}
Authorization: Bearer dt_…

{
  "product": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/products/:id/restore

Restore a product; on Free with another active product it is 402 `product_limit`.

Example
POST https://darthtasks.com/api/v1/products/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "product": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/routines

The product's routines.

Example
GET https://darthtasks.com/api/v1/products/{id}/routines
Authorization: Bearer dt_…

{
  "routines": "…"
}
session or tokenread
POST /api/v1/products/:id/routines

Add to the product's routines.

Example
POST https://darthtasks.com/api/v1/products/{id}/routines
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "routine": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/backlog

The product's backlog.

Example
GET https://darthtasks.com/api/v1/products/{id}/backlog
Authorization: Bearer dt_…

{
  "items": "…"
}
session or tokenread
POST /api/v1/products/:id/backlog

Add to the product's backlog.

Example
POST https://darthtasks.com/api/v1/products/{id}/backlog
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/releases

The product's releases.

Example
GET https://darthtasks.com/api/v1/products/{id}/releases
Authorization: Bearer dt_…

{
  "releases": "…"
}
session or tokenread
POST /api/v1/products/:id/releases

Add to the product's releases.

Example
POST https://darthtasks.com/api/v1/products/{id}/releases
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "release": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/numbers

The product's numbers.

Example
GET https://darthtasks.com/api/v1/products/{id}/numbers
Authorization: Bearer dt_…

{
  "numbers": "…"
}
session or tokenread
POST /api/v1/products/:id/numbers

Add to the product's numbers. A sixth number is 422.

Example
POST https://darthtasks.com/api/v1/products/{id}/numbers
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "number": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/areas/:id/routines

An area's routines (same shape as a product's).

Example
GET https://darthtasks.com/api/v1/areas/{id}/routines
Authorization: Bearer dt_…

{
  "routines": "…"
}
session or tokenread
POST /api/v1/areas/:id/routines

Add a routine to an area.

Example
POST https://darthtasks.com/api/v1/areas/{id}/routines
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "routine": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/routines/:id

Change a routine.

Example
PATCH https://darthtasks.com/api/v1/routines/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "routine": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/routines/:id

Remove a routine.

Example
DELETE https://darthtasks.com/api/v1/routines/{id}
Authorization: Bearer dt_…

{
  "routine": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/routines/:id/restore

Restore a routine.

Example
POST https://darthtasks.com/api/v1/routines/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "routine": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/backlog/:id

Change a item.

Example
PATCH https://darthtasks.com/api/v1/backlog/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/backlog/:id

Remove a item.

Example
DELETE https://darthtasks.com/api/v1/backlog/{id}
Authorization: Bearer dt_…

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/backlog/:id/restore

Restore a item.

Example
POST https://darthtasks.com/api/v1/backlog/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/backlog/:id/move

Move a backlog card to a column (`column`) and between neighbours (`before`, `after`).

Example
POST https://darthtasks.com/api/v1/backlog/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/backlog/:id/promote

Promote a backlog item to a task or a project (`to`); linked both ways.

Example
POST https://darthtasks.com/api/v1/backlog/{id}/promote
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "promoted": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/releases/:id

Change a release.

Example
PATCH https://darthtasks.com/api/v1/releases/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "release": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/releases/:id

Remove a release.

Example
DELETE https://darthtasks.com/api/v1/releases/{id}
Authorization: Bearer dt_…

{
  "release": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/releases/:id/restore

Restore a release.

Example
POST https://darthtasks.com/api/v1/releases/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "release": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/releases/:id/ship

Mark a release shipped (`shippedAt`).

Example
POST https://darthtasks.com/api/v1/releases/{id}/ship
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "release": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/numbers/:id

Change a number.

Example
PATCH https://darthtasks.com/api/v1/numbers/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "number": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/numbers/:id

Remove a number.

Example
DELETE https://darthtasks.com/api/v1/numbers/{id}
Authorization: Bearer dt_…

{
  "number": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/requests

The product's requests, most asked first; `writable` is false on Free (earlier requests stay readable).

Example
GET https://darthtasks.com/api/v1/products/{id}/requests
Authorization: Bearer dt_…

{
  "requests": "…",
  "writable": "…"
}
session or tokenread
POST /api/v1/products/:id/requests/log

Log an ask (Pro): the same normalised title raises `count` and adds the source; otherwise a new row. Free → 402 `pro_required`.

Example
POST https://darthtasks.com/api/v1/products/{id}/requests/log
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "request": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/products/:id/requests/:rid

Change status or links (`backlogItemId`, `taskId`); with `mergeInto` merge this request into another.

Example
PATCH https://darthtasks.com/api/v1/products/{id}/requests/{rid}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "request": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/products/:id/requests/:rid

Move a request to Trash.

Example
DELETE https://darthtasks.com/api/v1/products/{id}/requests/{rid}
Authorization: Bearer dt_…

{
  "request": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/health

Health now: `state` (healthy, drifting, neglected) and `reasons` as sentences; `full` is false on Free (activity and routines only).

Example
GET https://darthtasks.com/api/v1/products/{id}/health
Authorization: Bearer dt_…

{
  "product": "…",
  "state": "…",
  "reasons": "…",
  "full": "…",
  "routines": "…"
}
session or tokenread
GET /api/v1/reviews

Recent review sessions and the Review entry (next review day, catch-up due, nudge, pending change sets).

Example
GET https://darthtasks.com/api/v1/reviews
Authorization: Bearer dt_…

{
  "reviews": "…",
  "entry": "…"
}
session or tokenread
GET /api/v1/reviews/entry

The Review entry on its own.

Example
GET https://darthtasks.com/api/v1/reviews/entry
Authorization: Bearer dt_…

{
  "nextReviewDay": "…",
  "lastReviewAt": "…",
  "catchUp": "…",
  "nudge": "…",
  "doneThisWeek": "…",
  "pendingChangeSets": "…"
}
session or tokenread
POST /api/v1/reviews/nudge/dismiss

Dismiss this week's in-app review nudge.

Example
POST https://darthtasks.com/api/v1/reviews/nudge/dismiss
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "week": "…"
}
session or tokenwrite
POST /api/v1/reviews

Start a review (`kind`: shutdown, weekly, catch_up), or get the open one for this kind and week.

Example
POST https://darthtasks.com/api/v1/reviews
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "review": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/reviews/:id

A review session with its data: `shutdown` tasks, the weekly `steps` with `minutesLeft`, or the `catchUp` batches.

Example
GET https://darthtasks.com/api/v1/reviews/{id}
Authorization: Bearer dt_…

{
  "session": "…",
  "shutdown": "…",
  "steps": "…",
  "minutesLeft": "…",
  "autoSkipped": "…",
  "catchUp": "…"
}
session or tokenread
PATCH /api/v1/reviews/:id

Save `step` and `state`, or `finish: true` (a shutdown with an undecided task is 422 `undecided_items`).

Example
PATCH https://darthtasks.com/api/v1/reviews/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "review": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/reviews/:id/decide

A shutdown decision for a task: `tomorrow`, `later` (clears Planned), `drop` or `skip`, with an optional `resumeNote`.

Example
POST https://darthtasks.com/api/v1/reviews/{id}/decide
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "task": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/reviews/:id/catch-up

A catch-up batch as one change set: `moveAll` (Planned today) or `restartRoutines`, with `ids`.

Example
POST https://darthtasks.com/api/v1/reviews/{id}/catch-up
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "batch": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/projects/:id/reviewed

Mark a project reviewed (`lastReviewedAt`).

Example
POST https://darthtasks.com/api/v1/projects/{id}/reviewed
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "project": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/products/:id/reviewed

Mark a product reviewed (`lastReviewedAt`).

Example
POST https://darthtasks.com/api/v1/products/{id}/reviewed
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "product": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/weeks/:w/outcomes

The week's outcomes (`:w` is an ISO week like 2026-W47).

Example
GET https://darthtasks.com/api/v1/weeks/{w}/outcomes
Authorization: Bearer dt_…

{
  "outcomes": "…"
}
session or tokenread
POST /api/v1/weeks/:w/outcomes

Add a week outcome with an optional `day` and `slot`.

Example
POST https://darthtasks.com/api/v1/weeks/{w}/outcomes
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "outcome": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/weeks/:w/outcomes/:id

Change an outcome (title, day, slot, done).

Example
PATCH https://darthtasks.com/api/v1/weeks/{w}/outcomes/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "outcome": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/weeks/:w/outcomes/:id

Remove an outcome.

Example
DELETE https://darthtasks.com/api/v1/weeks/{w}/outcomes/{id}
Authorization: Bearer dt_…

{
  "outcome": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/reviews/:id/prep

The weekly review's AI preparation: `status` (none, queued, ready, failed, meter, no_key), the summary and the proposed change set. A token limited to areas or products gets no summary and only its own items.

Example
GET https://darthtasks.com/api/v1/reviews/{id}/prep
Authorization: Bearer dt_…

{
  "prep": "…"
}
session or tokenread
POST /api/v1/reviews/:id/prep

Start the preparation (Pro and Lifetime; Free is 402). Answers 202 with the current `prep`; a limited token is refused (a preparation covers the whole account).

Example
POST https://darthtasks.com/api/v1/reviews/{id}/prep
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "prep": "…"
}
session or tokenwrite
POST /api/v1/projects/:id/make-routine

Turn a project with a home into a weekly routine named after it; the project is done and its open tasks stay as loose tasks. One Undo reverses all of it.

Example
POST https://darthtasks.com/api/v1/projects/{id}/make-routine
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/quarters/:q

The quarter view: `bets`, `segments` (13 ISO weeks with `plannedMin`, `freeMin`, `over`, `overByMin`) and `weekOfQuarter`. `:q` is like 2027-Q1.

Example
GET https://darthtasks.com/api/v1/quarters/{q}
Authorization: Bearer dt_…

{
  "quarter": "…",
  "range": "…",
  "today": "…",
  "weekOfQuarter": "…",
  "bets": "…",
  "segments": "…",
  "workingWeek": "…"
}
session or tokenread
GET /api/v1/quarters/:q/bets

The quarter's bets with each project's next action. A token limited to areas or products gets only bets whose project is inside its limit.

Example
GET https://darthtasks.com/api/v1/quarters/{q}/bets
Authorization: Bearer dt_…

{
  "bets": "…"
}
session or tokenread
POST /api/v1/quarters/:q/bets

Make a project a bet on a `side` (work or personal) with an optional `outcome`. A 4th active bet on a side is 409 `bet_cap` with `details.prompt` and `details.active`; repeat with `resolve` `{action: pause, betId}`, `{action: someday}` or `{action: override}`.

Example
POST https://darthtasks.com/api/v1/quarters/{q}/bets
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "bet": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/quarters/:q/bets/:id

Change a bet's `outcome`, `side` or `status` (active, paused, done).

Example
PATCH https://darthtasks.com/api/v1/quarters/{q}/bets/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "bet": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/quarters/:q/bets/:id

Remove a bet.

Example
DELETE https://darthtasks.com/api/v1/quarters/{q}/bets/{id}
Authorization: Bearer dt_…

{
  "bet": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/quarters/:q/bets/:id/restore

Bring a removed bet back.

Example
POST https://darthtasks.com/api/v1/quarters/{q}/bets/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "bet": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/import

Import from Todoist (project CSV, or a zip of them), Things (JSON in Things' URL-scheme shape) or OmniFocus (CSV export): multipart `source` and `file`, up to 10 MB. 202 with the queued `job`. Everything lands as one change set authored Import; undo it with `POST /api/v1/change-sets/:id/undo`. A limited token gets 403.

Example
POST https://darthtasks.com/api/v1/import
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "job": "…"
}
session or tokenwrite
GET /api/v1/import/:id

An import's `status` (queued, running, ready, failed), `summary` (counts and every skipped field), `changeSetId` and `error`.

Example
GET https://darthtasks.com/api/v1/import/{id}
Authorization: Bearer dt_…

{
  "job": "…"
}
session or tokenread
POST /api/v1/export

Export everything as a zip: darth-tasks.json (every entity), Markdown by area, product and project, and tasks.csv; attachments are listed with signed links valid 7 days. Works on every plan. A token with limitTo gets 403.

Example
POST https://darthtasks.com/api/v1/export
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "job": "…"
}
session or tokenread
GET /api/v1/export/:id

An export's `status`, `summary`, `expiresAt` and `expired`.

Example
GET https://darthtasks.com/api/v1/export/{id}
Authorization: Bearer dt_…

{
  "job": "…"
}
session or tokenread
GET /api/v1/export/:id/download

The export zip, for 7 days after it is ready; then 404.

Example
GET https://darthtasks.com/api/v1/export/{id}/download
Authorization: Bearer dt_…

{}
session or tokenread
GET /api/v1/attachments/:id/signed

An attachment through the signed link in an export (`exp`, `sig`), for a session of the same account, until the link expires.

Example
GET https://darthtasks.com/api/v1/attachments/{id}/signed
Authorization: Bearer <session token>

{}
app sessionread
POST /api/v1/report

Report a problem: `message` and the `screen` it came from go to support. Five an hour.

Example
POST https://darthtasks.com/api/v1/report
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "sent": "…"
}
app sessionwrite
DELETE /api/v1/account

Delete the account (body `{"confirm": true}`): the session stops working, tokens are revoked, the subscription is cancelled at once and the data is removed for good after 30 days. Billing records stay 5 years.

Example
DELETE https://darthtasks.com/api/v1/account
Authorization: Bearer <session token>

{
  "deleted": "…",
  "purgeAt": "…"
}
app sessionwrite
GET /api/v1/perspectives

Saved perspectives in sidebar order, each with `name`, `query` (filters joined by `match` all or any, `group`, `sort`, `dir`, `includeDone`) and `pinned`.

Example
GET https://darthtasks.com/api/v1/perspectives
Authorization: Bearer dt_…

{
  "perspectives": "…"
}
session or tokenread
POST /api/v1/perspectives

Save a perspective: `name`, `query` and optional `pinned`. Filter fields: state, tag, project, area, product, due, planned, estimate, priority, title. A token limited to areas or products cannot change perspectives (403).

Example
POST https://darthtasks.com/api/v1/perspectives
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "perspective": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/perspectives/:id

A perspective and its tasks evaluated now, in `groups` (`key`, `label`, `tasks`), 200 tasks a page; `?offset=` with `nextOffset` pages on. A limited token gets only tasks inside its limit.

Example
GET https://darthtasks.com/api/v1/perspectives/{id}
Authorization: Bearer dt_…

{
  "perspective": "…",
  "total": "…",
  "offset": "…",
  "nextOffset": "…",
  "groups": "…"
}
session or tokenread
PATCH /api/v1/perspectives/:id

Change a perspective's `name`, `query` or `pinned`.

Example
PATCH https://darthtasks.com/api/v1/perspectives/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "perspective": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/perspectives/:id/move

Reorder: place the perspective between `before` and `after` (ids or null).

Example
POST https://darthtasks.com/api/v1/perspectives/{id}/move
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "perspective": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/perspectives/:id

Remove a perspective; Undo in Activity brings it back with its pin.

Example
DELETE https://darthtasks.com/api/v1/perspectives/{id}
Authorization: Bearer dt_…

{
  "perspective": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/perspectives/:id/restore

Bring a removed perspective back.

Example
POST https://darthtasks.com/api/v1/perspectives/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "perspective": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/perspectives/preview

App-only: evaluate an unsaved `query` for the perspective builder.

Example
POST https://darthtasks.com/api/v1/perspectives/preview
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "total": "…",
  "offset": "…",
  "nextOffset": "…",
  "groups": "…"
}
app sessionread
GET /api/v1/stats/estimates

Estimate accuracy (actual minutes divided by estimated) from completed tasks that have both: `overall`, by project (`projects`) and by tag (`tags`), each with `ratio`, `count`, `estimateMin` and `actualMin`. A limited token gets only rows inside its limit.

Example
GET https://darthtasks.com/api/v1/stats/estimates
Authorization: Bearer dt_…

{
  "overall": "…",
  "projects": "…",
  "tags": "…"
}
session or tokenread
GET /api/v1/weeks/:w/balance

Attention balance for an ISO week (Pro; Free is 402): per product and area the actual share, the planned share and a word (`below`, `on`, `above`, `none`). Time share when the week has minutes, completion share otherwise. No score or rank.

Example
GET https://darthtasks.com/api/v1/weeks/{w}/balance
Authorization: Bearer dt_…

{
  "balance": "…"
}
session or tokenread
GET /api/v1/weeks/:w

The week view: Monday to Sunday with `outcomes`, placed `blocks` (with titles), `workingWeek` and the week's `capacity` (`plannedMin`, `freeMin`, `over`, `overByMin`).

Example
GET https://darthtasks.com/api/v1/weeks/{w}
Authorization: Bearer dt_…

{
  "week": "…",
  "from": "…",
  "to": "…",
  "workingWeek": "…",
  "outcomes": "…",
  "blocks": "…",
  "capacity": "…"
}
session or tokenread
GET /api/v1/lists

Quick lists (not templates, not archived unless `archived=1`), with `total` and `checked` counts. Filters: `projectId`, `taskId`, `templates=1`.

Example
GET https://darthtasks.com/api/v1/lists
Authorization: Bearer dt_…

{
  "lists": "…"
}
session or tokenread
POST /api/v1/lists

Create a list: `title`, optional `projectId` or `taskId`, `pinDate`, `sections`, `items` (in order), or `fromTemplateId` / `fromTemplate` (a template's title) to copy its sections and items unchecked.

Example
POST https://darthtasks.com/api/v1/lists
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/lists/:id

A list and its items in order.

Example
GET https://darthtasks.com/api/v1/lists/{id}
Authorization: Bearer dt_…

{
  "list": "…",
  "items": "…"
}
session or tokenread
PATCH /api/v1/lists/:id

Change a list's `title`, `pinDate`, `projectId`, `taskId` or `sections`.

Example
PATCH https://darthtasks.com/api/v1/lists/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "list": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/lists/:id

Move a list to Trash.

Example
DELETE https://darthtasks.com/api/v1/lists/{id}
Authorization: Bearer dt_…

{
  "list": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/restore

Bring a list back from Trash.

Example
POST https://darthtasks.com/api/v1/lists/{id}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "list": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/paste

Add one item per pasted line (`text`), in order, optionally in a `section`.

Example
POST https://darthtasks.com/api/v1/lists/{id}/paste
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/reset

Uncheck every item.

Example
POST https://darthtasks.com/api/v1/lists/{id}/reset
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/template

Save the list as a template (sections and items, unchecked).

Example
POST https://darthtasks.com/api/v1/lists/{id}/template
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/lists/:id/items

A list's items in order.

Example
GET https://darthtasks.com/api/v1/lists/{id}/items
Authorization: Bearer dt_…

{
  "items": "…"
}
session or tokenread
POST /api/v1/lists/:id/items

Add an item: `title`, optional `section`.

Example
POST https://darthtasks.com/api/v1/lists/{id}/items
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/lists/:id/items/:itemId

Change an item's `title`, `section` or `checked`. A list fully checked is archived 3 days later; unchecking cancels it.

Example
PATCH https://darthtasks.com/api/v1/lists/{id}/items/{itemId}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/lists/:id/items/:itemId

Remove an item.

Example
DELETE https://darthtasks.com/api/v1/lists/{id}/items/{itemId}
Authorization: Bearer dt_…

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/items/:itemId/restore

Bring a removed item back.

Example
POST https://darthtasks.com/api/v1/lists/{id}/items/{itemId}/restore
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "item": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
POST /api/v1/lists/:id/items/:itemId/task

Turn an item into a task (in the list's project, or the Inbox); the item links to it.

Example
POST https://darthtasks.com/api/v1/lists/{id}/items/{itemId}/task
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/templates

Project templates with counts of headings, tasks and lists. A token limited to areas or products gets none.

Example
GET https://darthtasks.com/api/v1/templates
Authorization: Bearer dt_…

{
  "templates": "…"
}
session or tokenread
POST /api/v1/templates

Save a project as a template: its headings, tasks, lists and brief, with dates as offsets from `startDate` (default today). Start one with `POST /api/v1/projects` and `fromTemplateId` plus `startDate`.

Example
POST https://darthtasks.com/api/v1/templates
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "template": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/templates/:id

Rename a template.

Example
PATCH https://darthtasks.com/api/v1/templates/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "template": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/templates/:id

Remove a template.

Example
DELETE https://darthtasks.com/api/v1/templates/{id}
Authorization: Bearer dt_…

{
  "template": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/projects/:id/milestones

The project's milestones in date order, each with its tasks.

Example
GET https://darthtasks.com/api/v1/projects/{id}/milestones
Authorization: Bearer dt_…

{
  "milestones": "…"
}
session or tokenread
POST /api/v1/projects/:id/milestones

Add a milestone (`name`, optional `date`). Put a task under it with `PATCH /api/v1/tasks/:id` and `milestoneId`.

Example
POST https://darthtasks.com/api/v1/projects/{id}/milestones
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "milestone": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/projects/:id/milestones/:mid

Change a milestone's `name` or `date`.

Example
PATCH https://darthtasks.com/api/v1/projects/{id}/milestones/{mid}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "milestone": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/projects/:id/milestones/:mid

Remove a milestone; its tasks stay in the project.

Example
DELETE https://darthtasks.com/api/v1/projects/{id}/milestones/{mid}
Authorization: Bearer dt_…

{
  "milestone": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/projects/:id/tabs

Which workspace tabs the project has earned: `lists`, `milestones`, `reference`.

Example
GET https://darthtasks.com/api/v1/projects/{id}/tabs
Authorization: Bearer dt_…

{
  "tabs": "…"
}
session or tokenread
GET /api/v1/projects/:id/reference

The project's reference page: one Markdown `brief`, `links` with titles and `files`.

Example
GET https://darthtasks.com/api/v1/projects/{id}/reference
Authorization: Bearer dt_…

{
  "reference": "…"
}
session or tokenread
PUT /api/v1/projects/:id/reference

Set the reference page's `brief` (Markdown text, shown escaped) and `links`.

Example
PUT https://darthtasks.com/api/v1/projects/{id}/reference
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "reference": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/products/:id/reference

The product's reference page (same shape as a project's).

Example
GET https://darthtasks.com/api/v1/products/{id}/reference
Authorization: Bearer dt_…

{
  "reference": "…"
}
session or tokenread
PUT /api/v1/products/:id/reference

Set the product's reference page.

Example
PUT https://darthtasks.com/api/v1/products/{id}/reference
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "reference": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/attachments

Files on a parent: `parentType` (task, project, product) and `parentId`.

Example
GET https://darthtasks.com/api/v1/attachments
Authorization: Bearer dt_…

{
  "attachments": "…"
}
session or tokenread
POST /api/v1/attachments

Upload a file as the raw request body with `Content-Type` and `Content-Length`, and `parentType`, `parentId`, `fileName` in the query. Up to 25 MB (413 above), allowed types only (415 otherwise).

Example
POST https://darthtasks.com/api/v1/attachments
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "attachment": "…",
  "rev": "…"
}
session or tokenwrite
GET /api/v1/attachments/:id

The file itself. Images and PDF are shown inline (`download=1` forces a download); other types always download; `X-Content-Type-Options: nosniff`.

Example
GET https://darthtasks.com/api/v1/attachments/{id}
Authorization: Bearer dt_…

{
  "(file)": "…"
}
session or tokenread
DELETE /api/v1/attachments/:id

Remove a file; it is gone for everyone, its owner included.

Example
DELETE https://darthtasks.com/api/v1/attachments/{id}
Authorization: Bearer dt_…

{
  "attachment": "…",
  "rev": "…"
}
session or tokenwrite
GET /api/v1/reminders

Reminders, newest first: `kind` (task, review_nudge, change_set), `fireAt`, `channel` (push, email), `status` (pending, sent, failed, blocked) and `error` in words. A token limited to areas or products gets only task reminders inside its limit.

Example
GET https://darthtasks.com/api/v1/reminders
Authorization: Bearer dt_…

{
  "reminders": "…"
}
session or tokenread
GET /api/v1/reminders/log

The delivery log: every reminder that fired, with its status and the reason when it failed or was blocked.

Example
GET https://darthtasks.com/api/v1/reminders/log
Authorization: Bearer dt_…

{
  "reminders": "…"
}
session or tokenread
GET /api/v1/reminders/:id

One reminder.

Example
GET https://darthtasks.com/api/v1/reminders/{id}
Authorization: Bearer dt_…

{
  "reminder": "…"
}
session or tokenread
POST /api/v1/reminders

Remind about a task: `taskId`, `fireAt` (epoch ms) and `channel` (push or email). Push goes first; with email also on, a failed or blocked push falls back to email, logged as its own row.

Example
POST https://darthtasks.com/api/v1/reminders
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "reminder": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/reminders/:id

Move a pending reminder (`fireAt`) or change its `channel`.

Example
PATCH https://darthtasks.com/api/v1/reminders/{id}
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "reminder": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
DELETE /api/v1/reminders/:id

Cancel a reminder.

Example
DELETE https://darthtasks.com/api/v1/reminders/{id}
Authorization: Bearer dt_…

{
  "reminder": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/tasks/:id/focus-session

The task's open focus session (or null) and its total focus minutes.

Example
GET https://darthtasks.com/api/v1/tasks/{id}/focus-session
Authorization: Bearer dt_…

{
  "open": "…",
  "focusMinutes": "…"
}
session or tokenread
POST /api/v1/tasks/:id/focus-session

Start a focus session on the task (one at a time; a session left open elsewhere ends at the last time it was seen).

Example
POST https://darthtasks.com/api/v1/tasks/{id}/focus-session
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "session": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
PATCH /api/v1/tasks/:id/focus-session

`action`: `pause` (with an optional `resumeNote`, saved to the task), `resume`, `stop` or `heartbeat`. Ending a session adds its minutes to the task's actual time.

Example
PATCH https://darthtasks.com/api/v1/tasks/{id}/focus-session
Authorization: Bearer dt_…
Content-Type: application/json

{ … }

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
session or tokenwrite
GET /api/v1/tasks/:id/estimate-hint

The task's estimate and actual, and `hint` (`ratio`, `count`): actual ÷ estimate over 5 or more finished tasks in the same project or sharing a tag, else null.

Example
GET https://darthtasks.com/api/v1/tasks/{id}/estimate-hint
Authorization: Bearer dt_…

{
  "estimateMin": "…",
  "actualMin": "…",
  "hint": "…"
}
session or tokenread
GET /api/v1/devices

The account's push targets (label, platform, last seen) and the `vapidPublicKey` a browser subscribes with; a device's keys are never returned. App-only.

Example
GET https://darthtasks.com/api/v1/devices
Authorization: Bearer <session token>

{
  "devices": "…",
  "vapidPublicKey": "…"
}
app sessionread
POST /api/v1/devices

Register this browser (or, later, a native app) for push: `kind` (webpush, apns, fcm), `address`, `keys` for webpush, `platform`, `label`. The same address again refreshes `lastSeenAt`. A webpush address must be https on a known push service (422 otherwise). App-only.

Example
POST https://darthtasks.com/api/v1/devices
Authorization: Bearer <session token>
Content-Type: application/json

{ … }

{
  "device": "…",
  "rev": "…"
}
app sessionwrite
DELETE /api/v1/devices

Remove a push target by `address` or `id`. App-only.

Example
DELETE https://darthtasks.com/api/v1/devices
Authorization: Bearer <session token>

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
app sessionwrite
DELETE /api/v1/devices/:id

Remove a push target. App-only.

Example
DELETE https://darthtasks.com/api/v1/devices/{id}
Authorization: Bearer <session token>

{
  "result": "…",
  "rev": "…",
  "changeSet": "…"
}
app sessionwrite

Also available: GET /api/health, POST /webhooks/clerk, POST /webhooks/stripe, /mcp and https://mcp.darthtasks.com, /oauth/*

Capture from iPhone with a Shortcut

  1. In Darth Tasks, Settings › Agents: create a token with scope Capture. Copy it once.
  2. In the Shortcuts app, make a shortcut that receives Text and URLs from the Share Sheet.
  3. Add the action Get Contents of URL, method POST, to the address below, with the headers and JSON body shown.
  4. Share any page or text to the shortcut: it lands in your Inbox.
POST https://darthtasks.com/api/v1/tasks
Authorization: Bearer dt_…your capture token…
Content-Type: application/json

{ "title": "Shortcut Input", "links": [{ "url": "https://example.com/a" }] }

App-only by design

These stay in the app and are not offered to tokens:

  • Billing and plan changes
  • Account and settings changes
  • Token and agent management
  • Calendar connection
  • AI suggestions and the AI key
  • Voice upload
  • Device registration for notifications
  • Live sync
  • Report a problem
  • Account deletion