List tasks

Vincere tasks assigned to you, created by you or followed by you, with due date and status.

GET https://cotlet.dev/api/v1/vincere/tasks

read

Lists tasks as the Task board shows them. scope picks the section: assigned_to_me, created_by_me or following. status keeps outstanding, overdue or completed tasks. Each task has its subject, type, due date and time, assignee and the record it is linked to.

Parameters

Parameters: list_tasks
NameTypeDescription
scope enum enum assigned_to_me, created_by_me or following. Default: assigned_to_me.
status enum enum outstanding, overdue or completed. Default: all.
limit integer integer How many tasks to return on one page.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/vincere/tasks \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("vincere", "list_tasks")
Node.js
const result = await cotlet.call('vincere', 'list_tasks');
CLI
cotlet call vincere list_tasks

Example response

JSON

{
  "tasks": [
    {
      "task_id": "T-5521",
      "subject": "Send Priya the job description",
      "type": "Candidate",
      "due": "2026-10-23T10:00:00",
      "assignee": "Dana Fox",
      "status": "outstanding",
      "candidate_id": "88214"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.