Skip to main content
Update a task using its id from List Tasks. Send text to edit the action item, completed: true to mark it done, or completed: false to reopen it. You can update text and completion together. Omitted fields remain unchanged, and repeating the same request is safe.
Update tasks owned by current members of the key’s workspace, matching workspace task listing.
Existing keys work without an additional scope or a new key.

Parameters

Provide at least one of completed or text. Empty or whitespace-only text and unsupported fields are rejected.

Edit Task Text

This request updates the text without changing completion status. Use /v1/me/tasks.update for a personal key.
To edit the text and reopen the task together, include both fields:

Example Response

The response contains taskId and the fields you supplied. A text-only update returns taskId and text; an update of both fields returns all three. The update is reflected in Jamie and subsequent tasks.list responses.

Error Responses

Missing tasks and tasks outside your write access both return Task not found or not writable.