POST /v2/tasks/quick (the quick_add_task tool) creates a task from one sentence, with the same
parser as the app’s quick entry. It reads English and French, and the tokens can come in any
order.
Priority
Priority 4, “goal of the day”, cannot be typed: set it with
update_task.
Project or area
#name is compared with the start of your project names, ignoring case and accents. When no
project matches, your areas are tried. A #word that matches nothing, or matches several, stays in
the title as typed.
Only projects and areas are matched here: #heading does not file a task under a heading through
the API.
Dates
A lone small number (“pay invoice 3”) is never read as a date.
What is read but not kept
The parser understands more than this operation stores. These are recognised and removed from the title, but the created task does not carry them:
To create a repeating task or set a duration, use
create_task with repeat and durationMin.
Deadlines
The parser never produces a deadline: a date in the sentence is always the plan. Pass the deadline alongside the sentence:The answer
The response carries the created task and what the parser understood:422 empty_title.