Skip to main content
Language Selector

  1. Other Languages

    (machine translation)

Planview Customer Success Center

Application API (v1): Update a Task Card

  1. Last updated
  2. Save as PDF

LeanKit's Application API v1 is deprecated. New integration projects should use our v2 API suite found here: https://success.planview.com/Planview_LeanKit/LeanKit_API/01_v2.

This method updates a Task Card on a Card's Taskboard. The request body is the same as Add Card. If you plan to change Card Type, see Add Task Card for more information on using the appropriate Card Type ID for Task Cards.

Request URL (POST):

https://{accountname}.leankit.com/kanban/api/v1/board/{boardId}/update/card/{cardId}/tasks/{taskCardId}

Sample Request:

https://myaccount.leankit.com/kanban/api/v1/board/256064019/update/card/256501042/tasks/256501044
{
  "Id": 256501044,
  "Title": "Task 1 - Updated",
  "Description": "New description of task",
  "TypeId": 256291537,
  "Priority": 1,
  "Size": 0,
  "IsBlocked": false,
  "BlockReason": null,
  "Index": 1,
  "StartDate": null,
  "DueDate": null,
  "ExternalSystemName": null,
  "ExternalSystemUrl": null,
  "ExternalCardID": null,
  "Tags": null,
  "AssignedUserIds": [],
  "ClassOfServiceId": 0
}

Sample Response:

{
  "ReplyData": [
    {
      "BoardVersion": 42,
      "CardDTO": {
        "SystemType": "Card",
        "BoardId": 256064019,
        "BoardTitle": "Sample Board",
        "LaneId": 256485507,
        "LaneTitle": "ToDo",
        "Title": "Task 1 - Updated",
        "Description": "New description of task",
        "Type": {
          "Id": 256291537
        },
        "TypeId": 256291537,
        "Priority": 1,
        "PriorityText": "Normal",
        "TypeName": "Subtask",
        "TypeIconPath": null,
        "TypeColorHex": "#F8F7D2",
        "Size": 0,
        "Active": false,
        "Color": "#F8F7D2",
        "Icon": "",
        "Version": 5,
        "AssignedUsers": [],
        "IsBlocked": false,
        "BlockReason": null,
        "BlockStateChangeDate": null,
        "Index": 1,
        "StartDate": null,
        "DueDate": null,
        "ExternalSystemName": null,
        "ExternalSystemUrl": null,
        "ExternalCardID": null,
        "ExternalCardIdPrefix": null,
        "Tags": null,
        "ParentBoardId": 0,
        "ParentTaskboardId": 256422779,
        "CountOfOldCards": 0,
        "CardContexts": [],
        "LastMove": "10/14/2015 04:52:11 PM",
        "LastActivity": "10/14/2015 05:22:57 PM",
        "DateArchived": null,
        "CommentsCount": 0,
        "LastComment": null,
        "AttachmentsCount": 0,
        "LastAttachment": null,
        "CreateDate": "10/14/2015",
        "ActualStartDate": "10/14/2015 8:51:51 PM",
        "ActualFinishDate": null,
        "AssignedUserName": "",
        "AssignedUserId": 0,
        "AssignedUserIds": [],
        "GravatarLink": "",
        "SmallGravatarLink": "",
        "IsOlderThanXDays": false,
        "Id": 256501044,
        "DrillThroughBoardId": null,
        "HasDrillThroughBoard": false,
        "DrillThroughStatistics": null,
        "DrillThroughCompletionPercent": null,
        "DrillThroughProgressTotal": null,
        "DrillThroughProgressComplete": null,
        "DrillThroughProgressSizeComplete": null,
        "DrillThroughProgressSizeTotal": null,
        "ClassOfServiceId": 0,
        "ClassOfServiceTitle": null,
        "ClassOfServiceIconPath": null,
        "ClassOfServiceColorHex": null,
        "ClassOfServiceCustomIconName": null,
        "ClassOfServiceCustomIconColor": null,
        "CardTypeIconColor": null,
        "CardTypeIconName": null,
        "CurrentTaskBoardId": null,
        "TaskBoardCompletionPercent": 0,
        "TaskBoardCompletedCardCount": 0,
        "TaskBoardCompletedCardSize": 0,
        "TaskBoardTotalCards": 0,
        "TaskBoardTotalSize": 0,
        "CurrentContext": null,
        "ParentCardId": null
      },
      "CardSubscription": null
    }
  ],
  "ReplyCode": 202,
  "ReplyText": "The Task was successfully updated."
}