Skip to content

Main Navigation Guide API Reference Try the Demo

Appearance

Sidebar Navigation

Overview

Setup

Getting Started

Configuration

Reverse Proxy

Notifications

AI Features

Concepts

Tasks & Priority

Snooze & Time

Recurrence

Reminders

Quotas

API Reference

Overview

System

GET Health check

GET OpenAPI specification

Tasks

GET List tasks

POST Create task

GET Counts for the nav badges

GET Get task

DELETE Delete task (soft delete to trash)

PATCH Update task

POST Mark task done

POST Mark task undone (reopen / put back)

POST Log progress on a tracked task

POST Skip this occurrence without completing it

POST Confirm an assistant-proposed task

POST Snooze task

POST Restore task from trash

POST Retry AI enrichment

GET What Process works through

Labels

GET List registered labels

POST Register a label

DELETE Deregister a label

Time slots

GET List time slots

POST Create a time slot

DELETE Remove a time slot

PATCH Rename a time slot and/or move its start

Bulk Operations

POST Mark multiple tasks done

POST Snooze multiple tasks

POST Snooze all overdue tasks

POST Edit multiple tasks

POST Soft-delete multiple tasks

POST Complete multiple tasks in one request

Reminders

POST Consider quota prompts (no progress)

POST Did it — log progress on quota prompts

POST Put back handled quota prompts

POST Mark task-segment rows considered

POST Defer task-segment rows to tomorrow

POST Put task-segment rows back

POST Target tasks today

GET Today's incomplete reminders grouped by time slot

Quotas

GET Every open quota for the user

Projects

GET List projects

POST Create project

PATCH Reorder projects

GET Get project

DELETE Delete project

PATCH Update project

Undo

POST Undo last action

POST Redo last undone action

GET Undo stack status

GET Undo history

POST Undo several actions

POST Redo several actions

Trash

GET List trashed tasks

DELETE Empty trash (permanent delete)

Export

GET Export user data

Webhooks

GET List webhooks

POST Create webhook

DELETE Delete webhook

PATCH Update webhook

GET List recent webhook deliveries

Tokens

GET List API tokens

POST Create API token

DELETE Revoke API token

Auth

POST Exchange a Bearer token for a web session cookie

GET Current user

Stats

GET Get user statistics

GET Query completion history

User

GET Get the user's preferences

PATCH Update the user's preferences

Review

GET Start a review session

POST Act on a review session

AI

GET AI status and activity

POST Test an AI feature's model

POST Quick take on a new task

GET What's Next recommendations

POST Start Insights generation

GET Insights generation progress

GET Insights results

POST Recommend a project for each task

GET Possible duplicate tasks

Notifications

POST Act on a task from a notification

POST Dismiss all notifications

POST Send a test notification

Push

GET Web Push public key

POST Send a test Web Push notification

POST Register an APNs device

DELETE Unregister an APNs device

POST Register a widget push token

DELETE Unregister a widget push token

Automation

Getting Started

Examples

Webhooks

Apple Apps

Setup

Widgets, Watch & Mac

Roadmap

OpenAPI specification

GET

/api/openapi

Responses

OpenAPI 3.1 YAML specification

Content-Type

text/yaml

JSON

"string"

GET

/api/openapi

Samples

Powered by VitePress OpenAPI

Pager

Previous page GET Health check

Next page GET List tasks