update_task
Update existing Kanboard tasks by modifying only specified fields. Pass task_id and at least one attribute to change; unused fields remain unchanged.
Instructions
Update the attributes of an existing Kanboard task (partial update). Only the fields you pass are changed; omitted fields keep their current values, and validation runs before any write, so an invalid call modifies nothing. At least one field besides 'task_id' must be provided — otherwise VALIDATION_ERROR. Column and swimlane changes must use move_task_position instead. Returns { ok: true, task_id } on success.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Task id to update (required). | |
| title | No | New task title. | |
| description | No | New task description. | |
| color_id | No | New color identifier (e.g. 'blue', 'red'). | |
| owner_id | No | New owner user id. | |
| creator_id | No | New creator user id. | |
| date_due | No | New due date as ISO 8601 string, Unix epoch seconds (integer), or null to clear. | |
| category_id | No | New category id. | |
| score | No | New complexity score. | |
| priority | No | New priority. | |
| reference | No | New external reference (e.g. issue URL). | |
| tags | No | New array of tag strings (replaces existing). | |
| date_started | No | New start date as ISO 8601 string, Unix epoch seconds (integer), or null to clear. |