Skip to main content

Update a task

Use this endpoint to update specific details of a task. Simply pass the parameters you want to change, and the task will be updated accordingly. Any parameters you don't include in the request will remain unchanged, ensuring that you only modify what's necessary without affecting other aspects of the task.

Parameters​

assignee
nullable string
ID of the assignee user.
description
nullable string
Description for the task. Can accept HTML string to format the content.
due_at
nullable string
Time at which the task is due.
milestone
nullable string
ID of the milestone.
remaining_minutes_estimate
nullable integer
Estimated remaining minutes.
list
nullable string
ID of the list.
start_at
nullable string
Time at which the task starts.
title
string
Title of the task.

Returns​

Returns the task object if the update succeeded. Throws an error if update parameters are invalid.

put
/api/tasks/{id}
curl -X PUT https://{workspace}.kitchen.co/api/tasks/{id} \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'X-Requested-With: XMLHttpRequest' \
    -H 'Authorization: Bearer {API_KEY}'
Response
{
  "assignee": "u_c3715664badcadf714053dd0",
  "author": "u_e2e07ccb713c2afe739a7c04",
  "board": "tskb_b208f0bf2d21fa7fd5a0a577",
  "completed": 0,
  "completed_at": null,
  "completer": null,
  "created_at": "2024-03-21T07:52:35+00:00",
  "description": "The task description",
  "due_at": null,
  "due_reminder": null,
  "due_reminder_sent_at": null,
  "id": "tsk_9bbcb52099a37312fbff58c8",
  "milestone": "mst_c26f8070cddd1e226f4f79b3",
  "remaining_minutes_estimate": null,
  "list": "tskl_3a5afbeeb173e27d669942bb",
  "start_at": null,
  "title": "The task title",
  "updated_at": "2024-03-21T07:52:35+00:00"
}