List Tasks
Module · Stable
List tasks with optional filters by status, assignee, or linked contact, company, or deal.
Returns tasks matching optional filters. status: todo | in_progress | done | cancelled. assigned_to and entity_type/entity_id filter by person or linked contact, company, or deal. limit defaults to 50. Returns the tasks array and a count — suitable for downstream map steps.
When to use
Section titled “When to use”Use when you have a deal_id, company_id, or contact_id from an upstream step (e.g. Find Deal or Find Contact) and need to pull all open or overdue tasks for that record. The resulting tasks array feeds naturally into a For each loop for per-task processing or notification.
When not to use
Section titled “When not to use”To act on a single known task, use Update Task or Complete Task directly — listing first is unnecessary overhead. To create a new task, use Create Task. To check whether a record’s checklist gates are met, use Checklist status instead.
Inputs
Section titled “Inputs”Configured per use: status, assigned_to, entity_type, entity_id, limit.
Outputs
Section titled “Outputs”Auto-generated from the skill registry (load_skills()). Do not edit by hand.