Skip to main content

Update a card

Use this endpoint to update specific details of a card. Simply pass the parameters you want to change, and the card 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 card.

Parameters​

assignee
nullable string
ID of the assignee user.
description
nullable string
Description for the card. Can accept HTML string to format the content.
due_at
nullable string
Time at which the card 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 card starts.
title
string
Title of the card.

Returns​

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

put
/api/cards/{id}
curl -X PUT https://{workspace}.kitchen.co/api/cards/{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 card 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 card title",
  "updated_at": "2024-03-21T07:52:35+00:00"
}