Tasks

Read Tasks: one task by id, or tasks filtered by text, view, status, priority, tag, project, list or due range; view 'stats' gives counts, type 'list' the lists. ALWAYS pass dueFrom/dueTo when the question concerns a period. Compact rows unless detail is 'full'.

Note: type 'list' reads the lists; view 'stats' counts tasks instead of listing them.

{
  "view": "today",
  "timeZone": "America/New_York"
}

Add one task: task.title, plus the person's dueDate (YYYY-MM-DD), dueTime (HH:mm), priority, projectName or listId, area, tags, notes, checklist, recurrence and reminder offsets. With type 'list', a Tasks list (name), only when the person asks for one. Example: task { title 'Buy groceries', dueDate 2026-07-02, dueTime 18:00, tags ['errand'], reminderOffsetsMinutes [60] }.

Note: type 'list' with a name adds a list.

{
  "task": {
    "title": "Renew passport",
    "dueDate": "2026-10-15",
    "priority": "high"
  }
}

Apply ONE change to every task matching a filter, in a single call, for example moving all overdue tasks to a new due date. The filter runs in Vritto, so you never list or patch the tasks yourself. Returns a count and a small sample, not the rows. Tell the user what will change before you run it.

Note: Applies one change to every task matching the filter, up to 100.

{
  "filter": {
    "view": "overdue"
  },
  "patch": {
    "dueDate": "2026-09-28"
  }
}

Change one task by id: only the fields in patch change. patch.status 'done' completes it, and a recurring task's next occurrence is created by the server. With type 'list', rename or recolour a list. Resolve the id with tasks_find first.

Note: patch.status 'done' completes a task; a recurring task's next occurrence follows. type 'list' renames or recolours a list.

{
  "id": "task_passport",
  "patch": {
    "dueDate": "2026-10-20"
  }
}

Delete (archive and cancel) one task, or with type 'list' archive a list, whose tasks are kept. Only for explicit deletion requests; a finished task is a tasks_change to done. Resolve the id with tasks_find first.

Note: type 'list' archives a list; its tasks are kept.