*Workflows › Reference › Actions › Projects*

# Get project

> Gets a project's record from its identifier, within the actor's account group.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `projects` |
| Group in the editor | Projects › Projects |
| Runs as | The owner of the workflow, with their permissions |
| Permission | View access to Projects. 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_projects_get`) |

ACTION `projects.find`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `projectId` | string | Yes |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `id` | string |  |
| `projectNumber` | string |  |
| `name` | string |  |
| `color` | string |  |
| `externalReference` | string |  |
| `projectTypeId` | string |  |
| `projectType` | json |  |
| `contact` | json |  |
| `location` | json |  |
| `startDate` | string |  |
| `endDate` | string |  |
| `status` | enum<string> |  `draft`, `budgeted`, `confirmed`, `in_progress`, `invoiced`, `completed`, `cancelled`, `archived` |
| `archived` | boolean |  |
| `orderIds` | string[] |  |
| `totalOrders` | number |  |
| `tags` | string[] |  |
| `customFields` | object[] |  |
| `customFields.id` | string |  |
| `customFields.name` | string |  |
| `customFields.value` | json |  |
| `source` | string |  |
| `createdAt` | string |  |
| `updatedAt` | string |  |
| `tagRefs` | object[] |  |
| `tagRefs.id` | string |  |
| `tagRefs.name` | string |  |

---

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