Update a task
Omitted fields are left unchanged on the existing record. To mark a task as done, set status=“COMPLETED”. To remove a due date, pass clear_due_date=true instead of setting due_date to null. To remove a reminder, pass clear_reminder=true.
Enum values (case-sensitive, uppercase):
- status: DRAFT | ACTIVE | COMPLETED | ARCHIVED
- priority: LOW | MEDIUM | HIGH
- visibility: RING | PERSONAL
- reminder_type: MINUTES | HOURS | DAYS | WEEKS
Authorizations
Path Parameters
Body
Set to true to remove the due date entirely.
Set to true to remove the reminder entirely.
ISO 8601 date string, e.g. '2025-12-31'. Use clear_due_date=true to remove it.
Task priority. Must be one of: LOW, MEDIUM, HIGH. Omit to leave unset.
LOW, MEDIUM, HIGH Unit for the reminder interval. Must be one of: MINUTES, HOURS, DAYS, WEEKS. Requires reminder_value to be set together.
MINUTES, HOURS, DAYS, WEEKS Numeric amount for the reminder interval.
Task status. Must be one of: DRAFT (not yet started), ACTIVE (in progress), COMPLETED (done), ARCHIVED (soft-deleted from view). Defaults to ACTIVE when omitted on create.
DRAFT, ACTIVE, COMPLETED, ARCHIVED Visibility scope. RING = visible to all tenant members; PERSONAL = visible only to the creator. Defaults to RING.
RING, PERSONAL