Skip to main content
PUT
Update a task by id (partial update — only provided fields are written).

Authorizations

x-api-key
string
header
required

Path Parameters

task_id
string
required

Body

application/json
clear_due_date
boolean
default:false

Set to true to remove the due date entirely.

clear_reminder
boolean
default:false

Set to true to remove the reminder entirely.

content
Content · object | null
due_date
string | null

ISO 8601 date string, e.g. '2025-12-31'. Use clear_due_date=true to remove it.

is_autosave
boolean
default:false
priority
enum<string> | null

Task priority. Must be one of: LOW, MEDIUM, HIGH. Omit to leave unset.

Available options:
LOW,
MEDIUM,
HIGH
reminder_type
enum<string> | null

Unit for the reminder interval. Must be one of: MINUTES, HOURS, DAYS, WEEKS. Requires reminder_value to be set together.

Available options:
MINUTES,
HOURS,
DAYS,
WEEKS
reminder_value
integer | null

Numeric amount for the reminder interval.

status
enum<string> | null

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.

Available options:
DRAFT,
ACTIVE,
COMPLETED,
ARCHIVED
title
string | null
visibility
enum<string> | null

Visibility scope. RING = visible to all tenant members; PERSONAL = visible only to the creator. Defaults to RING.

Available options:
RING,
PERSONAL

Response

200 - application/json

Minimal response body for task create/update.

id
string
required
created_at
string | null
updated_at
string | null