Skip to main content
Planview Customer Success Center

Application API (v1): Update a Task Card

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."
}