update_task

update_task

Update attributes of an existing task. Only fields you provide are changed; pass null to clear a nullable field. Provide assigneeIds to replace the current assignee set in one go (omit it to leave assignees untouched).

Connected web clients receive a realtime task:updated event so the change appears immediately in their UI.

Input

Field	Type	Required	Description
taskId	number	yes	Numeric ID of the task to update. Must belong to the user’s team.
title	string	no	New title. Must contain at least one non-whitespace character.
description	string | null	no	CommonMark markdown body. Replaces the existing description; pass null to clear. If a teammate has the task open in the web app, their next save will overwrite this update.
priority	string | null	no	One of low, medium, high, urgent, or null to clear.
dueDate	string | null	no	ISO 8601 date string (YYYY-MM-DD), or null to clear.
taskStatusId	number	no	Numeric status ID to move the task to. Must belong to the user’s team.
assigneeIds	array of string	no	When provided, replaces the current assignee set with these user IDs.

Example call

{
  "taskId": 421,
  "priority": "urgent",
  "taskStatusId": 3,
  "assigneeIds": ["u_abc123", "u_def456"]
}

Output

A single text content block containing a JSON object with the updated task.

Field	Type	Description
id	number	Numeric ID of the task.
number	number	Auto-incrementing task number within the team.
title	string	Task title.
priority	string | null	Priority after the update.
dueDate	string | null	Due date after the update.
taskStatusId	number	Status ID after the update.
updatedAt	string	ISO 8601 timestamp of the update.

Example output

{
  "id": 421,
  "number": 87,
  "title": "Wire up onboarding email",
  "priority": "urgent",
  "dueDate": "2026-05-12",
  "taskStatusId": 3,
  "updatedAt": "2026-05-08T11:02:08.000Z"
}

Errors

The tool returns isError: true with an explanatory text block when the task ID doesn’t exist or doesn’t belong to the user’s team.