Skip to main content
POST
List User Tasks

Authorizations

X-API-Key
string
header
required

Body

application/json
limit
integer | null

Maximum tasks to return. Defaults to 20, max 20.

cursor
string | null

Cursor returned by a previous list_user_tasks call.

statuses
enum<string>[] | null

Task statuses to include. Defaults to todo.

Available options:
todo,
done,
canceled
types
enum<string>[] | null

Exact stored task types: call, manual, section_approval.

  • All three can contain tasks for the user to review or act on: call requires logging a call, manual requires marking manual work done, and section_approval requires reviewing and approving grouped actions.
  • types is an exact task-kind filter.
  • For a request for tasks the user can approve, review, or act on, omit types so all task kinds are returned.
  • Use types only when the caller explicitly requests a particular task kind.
Available options:
call,
manual,
section_approval
searchQuery
string | null

Search text matched against prospect first name, last name, company name, and company domain.

assignedUserId
string | null

Optional assigned user id. Use the exact current userId from get_current_user or a userId returned by list_team_members. Defaults to the current MCP user.

includeTeamTasks
boolean
default:false

When true, preview tasks owned by active members of the current team, matching the UI's all-team task scope.

flowIds
(string | null)[] | null

Optional flow/enrollment ids to filter tasks. Use exact enrollmentId values returned by add_dynamic_action, list_enrollments, list_flow_plan_enrollments, or get_flow_enrollment; do not pass flowPlanId here.

taskIds
(string | null)[] | null

Optional task ids to fetch directly. Example item: task_123. Use taskId values returned by list_user_tasks, preview_task, get_flow_enrollment, or get_flow_workspace required actions.

fromUtc
string<date-time> | null

Created-from timestamp in UTC.

toUtc
string<date-time> | null

Created-to timestamp in UTC.

email
string | null

Prospect email filter.

firstName
string | null

Prospect first name filter.

lastName
string | null

Prospect last name filter.

companyDomain
string | null

Company domain filter.

Response

Tool result.