List tasks
Lists tasks from the Tasks area.
GET https://cotlet.dev/api/v1/peoplehr/tasks
read
Returns title, assignee, the employee the task is about, completion date and status of each task, grouped like the Tasks area: overdue, new, due today, upcoming, completed. Tasks without a completion date are never overdue.
Parameters
| Name | Type | Description |
|---|---|---|
| view string | string | mine or all. Default mine. all shows every task in the company to an admin, and the tasks you assigned to your team to a manager. |
| status string | string | One of overdue, new, due_today, upcoming, completed. Default all of them. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/peoplehr/tasks \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("peoplehr", "list_tasks")const result = await cotlet.call('peoplehr', 'list_tasks');cotlet call peoplehr list_tasksExample response
{
"tasks": [
{
"task_id": "tsk-3301",
"title": "Confirm equipment",
"assignee": "Dana Reyes",
"about": "Ana Lopez",
"completion_date": "2026-11-23",
"status": "New"
},
{
"task_id": "tsk-3188",
"title": "Collect signed contract",
"assignee": "Sam Okafor",
"about": "Jake Ortiz",
"completion_date": "2026-11-10",
"status": "Overdue"
}
],
"next_cursor": null
}