List tasks
Your tasks: due, overdue or all, with type, priority, due date and the linked record.
GET https://cotlet.dev/api/v1/recruiterflow/tasks
read
Lists tasks from the Tasks page, soonest due first. view picks one of the three tables Recruiterflow shows: my_due (My Due Tasks), my_overdue (My Overdue Tasks) or all (All Tasks). Each task carries its type, priority, assignee and the candidate, contact, job, company or deal it is linked to. Managers see tasks of their team according to their role.
Parameters
| Name | Type | Description |
|---|---|---|
| view enum | enum | my_due (default), my_overdue or all. |
| task_type enum | enum | To-do, Call, Email, SMS or LinkedIn Message, or a custom type your admin added. |
| limit integer | integer | 1 to 50. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/recruiterflow/tasks \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recruiterflow", "list_tasks")const result = await cotlet.call('recruiterflow', 'list_tasks');cotlet call recruiterflow list_tasksExample response
{
"tasks": [
{
"task_id": "55120",
"title": "Send Dana the salary range",
"task_type": "Call",
"priority": "None",
"due": "2026-10-29T10:00:00",
"assigned_to": "Dana Reyes",
"linked": {
"type": "candidate",
"id": "772318",
"name": "Dana Whitfield"
}
}
],
"next_cursor": null
}