Get tasks by swimlane and columnGET

Description

Returns all tasks in the cell confined by a column and swimlane. Both column and swimlane can be given by ID, name or index.

For date grouped columns, the number of tasks returned is limited to 20 by default. You can raise the limit up to 100.

When there are more tasks to fetch in the column, the response will have tasksLimited=true and a nextTaskId, which points at the next task in line. Pass it in the next request as startTaskId to retrieve the succeeding tasks.

Instead of startTaskId, you can use startGroupingDate to start at a certain date (date finished). Format: YYYY-MM-DD. You can also choose the order of the tasks, either ascending (asc) or descending (desc). Default: desc.

See Get task for details of included properties for the individual tasks.

Permissions

The API token needs All data read access.

Request format

curl https://kanbanflow.com/api/v1/tasks?<PARAM_1>=<PARAM_VALUE_1>&<PARAM_2>=<PARAM_VALUE_2>&...<PARAM_N>=<PARAM_VALUE_N>

Please note that you should URL encode the parameter, especially if it contains spaces.

Example request (swimlaneId, columnId)

curl https://kanbanflow.com/api/v1/tasks?swimlaneId=SqEB6zxG41e2&columnId=CBO1VNGqDc4K

Example request (startTaskId, limit, order)

curl https://kanbanflow.com/api/v1/tasks?swimlaneId=SqEB6zxG41e2&columnId=CBO1VNGqDc4K&startTaskId=T3s6UGyzY&limit=50&order=desc

Example request (startGroupingDate, limit, order)

curl https://kanbanflow.com/api/v1/tasks?swimlaneId=SqEB6zxG41e2&columnId=CBO1VNGqDc4K&startGroupingDate=2023-10-01&limit=50&order=asc

Example response

[
    {
        "swimlaneId": "SqEB6zxG41e2",
        "swimlaneName": "Team Beta",
        "columnId": "CBO1VNGqDc4K",
        "columnName": "In progress",
        "tasksLimited": false,
        "tasks": [
            {
                "_id": "T3s6UGyzY",
                "name": "Write report",
                "description": "",
                "color": "red",
                "columnId": "CBO1VNGqDc4K",
                "swimlaneId": "SqEB6zxG41e2",
                "createdTimestamp": "2023-12-31T20:00:00.000Z"
            }
        ]
    }
]

Valid parameters