> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Task events

> Platform events for tasks being created, modified, started, assigned and completed, with every filter they offer.

These events start an internal agent as tasks move through your team's work: when a task is created, assigned, started, changed or completed. See [Platform events](https://docs.conduit.ai/build-your-agent/agents/internal-agents/platform-events/overview.md) for how to add a trigger.

| Event | Runs when | Filters |
| - | - | - |
| [New task](#new-task) | A task is created. | Relation Filter, Task Creation Filter |
| [Task modified](#task-modified) | A task's status, assignee, or details change. | Changes, New status |
| [Task started](#task-started) | Work starts on a task. | None |
| [Task assigned](#task-assigned) | A task is assigned to a teammate or vendor. | None |
| [Task completed](#task-completed) | A task is completed. | Template, Checklist answer |

## New task

Runs when a task is created, by a teammate, by AI detection in a conversation, or through the API.

| Filter | Options |
| - | - |
| **Relation Filter** | **Reservation** or **Contact**. Pick the record the task is linked to, so the trigger can use fields from it. |
| **Task Creation Filter** | **All tasks (AI + Manual)**, **Only AI-detected tasks** or **Only manually created tasks**. |

**Example task:** "A new maintenance task was created. Check the last 90 days of tasks for the same listing and the same issue. If it has come up 3 or more times, add a note recommending replacement and post it to #maintenance in Slack."

## Task modified

Runs when a task changes. By default it watches the status only. Under **Changes**, pick which fields should start the agent. It runs when any of them change.

| Filter | Options |
| - | - |
| **Changes** | Any of **Status**, **Assignee**, **Priority**, **Due date** and **Category**. |
| **New status** | Optional. Only run when the task moves to one of these statuses. Lists your workspace's task statuses. Leave all unchecked to run on any status change. |

**Example task:** "This task's due date moved. If it's now after the guest's check-in, alert the property manager in Slack with the task, the listing and the arrival time."

## Task started

Runs when work starts on a task, such as when a cleaner starts a cleaning job. This event has no filters, so the agent runs every time any task starts.

**Example task:** "A task just started. If it's a cleaning task for a same-day turnover, message the incoming guest that their unit is being prepared."

## Task assigned

Runs when a task is assigned to a teammate or vendor. This event has no filters.

**Example task:** "A task was just assigned. If the assignee is a vendor, send them the listing's access instructions and the task details by SMS."

## Task completed

Runs when a task is completed.

| Filter | Options |
| - | - |
| **Template** | Optional. Only run when a task created from this template is completed. **Any template** runs for every task. |
| **Checklist answer** | Optional, after you pick a template. Only run when one of the template's checklist items has this answer. |

The comparisons for **Checklist answer** depend on the item:

| Checklist item | Comparisons |
| - | - |
| Checkbox | **Checked** or **Not checked** |
| Yes/no | **Yes** or **No** |
| Number, rating | **Equals**, **Greater than** or **Less than** a value |
| Text | **Contains** a value |

**Example task:** "The inspection task was completed and the cleanliness rating is below 3. Create a re-clean task for the same cleaner, due within 2 hours, and post the inspector's notes to #housekeeping."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.