Skip to main content
Planview Customer Success Center

Create a task card

POST /io/card/:cardId/tasks

Create a task card.

Example Requests

Minimum fields required

{
  "title": "The title of the task",
  "laneType": "ready",
  "typeId": "944576314"
}

All fields

{
    "title": "The title of the task",
    "typeId": "944576314",
    "laneType": "completed",
    "assignedUserIds": [ "2" ],
    "description": "The card description",
    "size": 1,
    "blockReason": "The block reason",
    "priority": "normal",
    "customIconId": "944576317",
    "customId": "Task header text",
    "externalLink": {
        "label": "The link label",
        "url": "https://www.leankit.com"
    },
    "index": 0,
    "plannedStart": "2020-01-20",
    "plannedFinish": "2020-02-01",
    "tags": [
        "tagOne",
        "tagTwo"
    ],
    "wipOverrideComment": "The override reason"
}

Creating a task at a specific lane position (index)

Note: Avoid using a specific index if possible. Operations that explicitly modify index are slower.

{
  "title": "The title of the task",
  "laneType": "ready",
  "typeId": "944576314",
  "index": 0
}

Example Successful Response

201 Created

{
    "id": "945261794",
    "index": 0,
    "description": "The card description",
    "tags": [
        "tagOne",
        "tagTwo"
    ],
    "title": "The title of the task",
    "size": 1,
    "version": "1",
    "priority": "normal",
    "createdOn": "2020-03-26T16:15:24Z",
    "archivedOn": null,
    "plannedStart": "2020-01-20",
    "plannedFinish": "2020-02-01",
    "actualStart": "2020-03-26T16:15:24Z",
    "actualFinish": "2020-03-26T16:15:24Z",
    "updatedOn": "2020-03-26T16:15:24Z",
    "movedOn": "2020-03-26T16:15:24Z",
    "color": "#F1C7C5",
    "iconPath": null,
    "blockedStatus": {
        "isBlocked": true,
        "reason": "The block reason",
        "date": "2020-03-26T16:15:24Z"
    },
    "board": {
        "id": "944576308",
        "title": "Sample Board",
        "version": "42",
        "isArchived": false
    },
    "taskBoard": {
        "id": "944576305",
        "version": "8"
    },
    "customIcon": {
        "id": "944576317",
        "title": "Date Dependent",
        "cardColor": "#FFFFFF",
        "iconColor": "212121",
        "iconName": "lk_icons_final_01-13",
        "iconPath": "https://myaccount.leankit.com/customicons/24/212121/lk_icons_final_01-13.png",
        "policy": ""
    },
    "customId": {
        "value": "Card header text",
        "prefix": null,
        "url": null
    },
    "externalLinks": [
        {
            "label": "The link label",
            "url": "https://www.leankit.com"
        }
    ],
    "lane": {
        "cardLimit": 0,
        "description": null,
        "id": "944576326",
        "index": 0,
        "laneClassType": "active",
        "laneType": "ready",
        "orientation": "vertical",
        "title": "ToDo"
    },
    "type": {
        "id": "944576314",
        "title": "New Feature",
        "cardColor": "#B8CFDF"
    },
    "assignedUsers": [
        {
            "id": "478440842",
            "emailAddress": "user@leankit.com",
            "fullName": "First Last",
            "firstName": "First",
            "lastName": "Last",
            "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
        }
    ],
    "comments": [],
    "attachments": [],
    "parentCards": [],
    "createdBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "firstName": "First",
        "lastName": "Last",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "updatedBy": {
        "id": "478440842",
        "emailAddress": "user@leankit.com",
        "firstName": "First",
        "lastName": "Last",
        "fullName": "First Last",
        "avatar": "https://myaccount.leankit.com/avatar/Show/478440842?s=25"
    },
    "movedBy": null,
    "archivedBy": null
}



Updated 2020-03-26 @ 12:03 PM