*Workflows › Reference › Actions › Planner*

# List tasks

> Lists planner tasks with filters by status, assignment, type, related document and due date, and pagination.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `tasks` |
| Group in the editor | Planner › Tasks |
| Runs as | The owner of the workflow, with their permissions |
| Permission | View access to Services. Administrators always pass; a module outside the plan blocks everyone. |
| Destructive | No: the public MCP catalogue does not mark it as destructive |
| Also available in | REST API, MCP (`filmo_tasks_list`) |

ACTION `tasks.findMany`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | number | No |  = `100` |
| `createdOn` | string | No |  |
| `createdAfter` | string | No |  |
| `createdBefore` | string | No |  |
| `createdFrom` | string | No |  |
| `createdTo` | string | No |  |
| `updatedOn` | string | No |  |
| `updatedAfter` | string | No |  |
| `updatedBefore` | string | No |  |
| `updatedFrom` | string | No |  |
| `updatedTo` | string | No |  |
| `from` | string | No |  |
| `to` | string | No |  |
| `assignedStaffId` | string | No |  |
| `assignedStaffIds` | string[] | No | Filter by assignedStaffId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |
| `isCompleted` | boolean | No |  |
| `type` | string | No |  |
| `types` | string[] | No | Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |
| `relatedDocumentId` | string | No |  |
| `relatedDocumentIds` | string[] | No | Filter by relatedDocumentId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |
| `dueOn` | string | No |  |
| `dueAfter` | string | No |  |
| `dueBefore` | string | No |  |
| `dueFrom` | string | No |  |
| `dueTo` | string | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `items` | object[] |  |
| `items.id` | string |  |
| `items.title` | string |  |
| `items.description` | string |  |
| `items.startDate` | string |  |
| `items.endDate` | string |  |
| `items.isAllDay` | boolean |  |
| `items.isCompleted` | boolean |  |
| `items.isRecurring` | boolean |  |
| `items.recurringGroupId` | string |  |
| `items.recurrencePattern` | json |  |
| `items.type` | string |  |
| `items.assignedStaffIds` | string[] |  |
| `items.projectId` | string |  |
| `items.relatedDocumentId` | string |  |
| `items.relatedDocumentType` | string |  |
| `items.appearance` | json |  |
| `items.createdAt` | string |  |
| `items.updatedAt` | string |  |
| `total` | number |  |
| `nextCursor` | string |  |

---

Canonical URL: https://docs.filmo.io/workflows/reference/actions/tasks-findmany  
Last updated: 2026-10-25