*Workflows › Reference › Actions › Planner*

# Look up task

> Looks up a task by its identifier.

## 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_get`) |

ACTION `tasks.find`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `taskId` | string | Yes |  |
| `includeRelatedData` | boolean | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `id` | string |  |
| `title` | string |  |
| `description` | string |  |
| `startDate` | string |  |
| `endDate` | string |  |
| `isAllDay` | boolean |  |
| `isCompleted` | boolean |  |
| `type` | string |  |
| `createdBy` | string |  |
| `updatedBy` | string |  |
| `createdAt` | string |  |
| `updatedAt` | string |  |
| `assignedStaffIds` | string[] |  |
| `assignedStaff` | object[] |  |
| `assignedStaff.id` | string |  |
| `assignedStaff.fullName` | string |  |
| `assignedStaff.email` | string |  |
| `assignedStaff.hasPlatformAccess` | boolean |  |
| `relatedDocumentId` | string |  |
| `relatedDocumentType` | string |  |
| `subRelatedDocumentId` | string |  |
| `subRelatedDocumentType` | string |  |
| `subRelatedDocumentCode` | string |  |
| `relatedDocumentData` | json |  |
| `appearance` | json |  |
| `recurrencePattern` | json |  |

---

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