Skip to main content
Planview Customer Success Center

Application API (v1): Update a Card (All Card Fields)

This method takes a Card JSON in the request body and updates the Card with the provided values. The JSON must include the Card ID. In this case, the Card ID is not used in the url, only in the request body.

Request URL (POST)

https://{accountname}.leankit.com/kanban/api/board/{boardId}/UpdateCard

Sample Request

https://myaccount.leankit.com/kanban/api/board/101000/UpdateCard
{
  "Id": 114043366,
  "LaneId": 63475141,
  "Title": "Updated Test Card 1",
  "Description": "Description of test card 1",
  "TypeId": 63454421,
  "Priority": 1,
  "Size": 0,
  "IsBlocked": false,
  "BlockReason": "",
  "Index": 0,
  "StartDate": null,
  "DueDate": "",
  "Tags": "",
  "ClassOfServiceId": null,
  "AssignedUserIds": [ 111, 222 ],
  "ExternalCardID": "",
  "ExternalSystemName": "",
  "ExternalSystemUrl": ""
}

Response

ReplyData contains the new BoardVersion after the card is updated.

{
  "ReplyData":[
    {
      "BoardVersion": 1148,
      "CardDTO":{
        "SystemType": "Card",
        "Id": 114043366,
        "BoardId": 101000,
        "BoardTitle": "Test Board",
        "LaneId": 63475141,
        "LaneTitle": "ToDo",
        "Title": "Updated Test Card 1",
        "Description": "Description of test card 1",
        "Type": { "Id":63454421 },
        "TypeId": 63454421,
        "Priority": 1,
        "PriorityText": "Normal",
        "TypeName": "Issue",
        "TypeIconPath": "../../Content/Images/Icons/Library/help.png",
        "TypeColorHex": "#f69679",
        "Size": 0,
        "Active": false,
        "Color": "#f69679",
        "Icon": "",
        "Version": 1,
        "AssignedUsers":[ ],
        "IsBlocked": false,
        "BlockReason": null,
        "BlockStateChangeDate": null,
        "Index": 0,
        "StartDate": null,
        "DueDate": null,
        "ExternalSystemName": null,
        "ExternalSystemUrl": null,
        "ExternalCardID": null,
        "ExternalCardIdPrefix": null,
        "Tags": null,
        "DrillThroughBoardId": null,
        "ParentCardId": null,
        "ParentBoardId": 0,
        "HasDrillThroughBoard": false,
        "DrillThroughCompletionPercent": 0,
        "DrillThroughProgressTotal": null,
        "DrillThroughProgressComplete": null,
        "DrillThroughProgressSizeComplete": null,
        "DrillThroughProgressSizeTotal": null,
        "ParentTaskboardId": null,
        "ClassOfServiceId": 0,
        "ClassOfServiceTitle": null,
        "ClassOfServiceIconPath": null,
        "ClassOfServiceColorHex": null,
        "CountOfOldCards": 0,
        "CardContexts": [ ],
        "CurrentTaskBoardId": null,
        "CurrentContext": null,
        "TaskBoardCompletionPercent": 0,
        "TaskBoardCompletedCardCount": 0,
        "TaskBoardCompletedCardSize": 0,
        "TaskBoardTotalCards": 0,
        "TaskBoardTotalSize": 0,
        "LastMove": "07/02/2014 07:38:44 AM",
        "LastActivity": "07/02/2014 07:42:53 AM",
        "DateArchived": null,
        "CommentsCount": 0,
        "LastComment": "",
        "AttachmentsCount": 0,
        "LastAttachment": "",
        "CreateDate": "07/02/2014",
        "AssignedUserName": "",
        "AssignedUserId": 111,
        "AssignedUserIds": [ 111, 222 ],
        "GravatarLink": "",
        "SmallGravatarLink": "",
        "IsOlderThanXDays": false
      },
      "CardSubscription": null
    }
  ],
  "ReplyCode":202,
  "ReplyText":"The Card was successfully updated."
}