Skip to content

/api/v1/lists/{listId}/tasks/{taskId} (PATCH)

PATCH
/api/v1/lists/{listId}/tasks/{taskId}
curl --request PATCH \
--url https://example.com/api/v1/lists/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/tasks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Content-Type: application/json' \
--data '{ "title": "example", "done": true, "starred": true, "dueDate": "example", "notes": "example", "assigneeId": "example", "reminderAt": "2026-04-15T12:00:00Z", "recurrence": "daily" }'
listId
required
string format: uuid
taskId
required
string format: uuid
Media type application/json
object
title
string
>= 1 characters <= 500 characters
done
boolean
starred
boolean
dueDate
string | null
/^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/
notes
string | null
<= 10000 characters
assigneeId
string | null
>= 1 characters
reminderAt
string | null format: date-time
recurrence
string | null
Allowed values: daily weekly weekdays monthly yearly

Updated

Media type application/json
object
id
required
string format: uuid
listId
required
string format: uuid
title
required
string
>= 1 characters <= 500 characters
done
required
boolean
starred
required
boolean
dueDate
required
string | null
/^\d{4}-\d{2}-\d{2}$/
notes
required
string | null
<= 10000 characters
notesUpdatedAt
required
string | null
rank
required
string
>= 1 characters
assigneeId
required
string | null
assignedToMe
boolean
reminderAt
required
string | null format: date-time
recurrence
required
string | null
Allowed values: daily weekly weekdays monthly yearly
createdAt
required
string
updatedAt
required
string
deletedAt
string
Example
{
"recurrence": "daily"
}

No valid session

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}

Not found

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}

Idempotency-Key reused with a different request

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}

No fields to update, assignee not eligible, or recurrence set without a due date

Media type application/problem+json
object
type
required
string
title
required
string
status
required
number
code
required
string
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example"
}