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

# Tasks

> Create, assign, and manage tasks linked to CRM records.

Tasks track action items across your team. Each task has a priority, status, assignee, and optional due date, and can be linked to any records.

## Tools

| Tool             | Description                      | Key Params                                                             |
| ---------------- | -------------------------------- | ---------------------------------------------------------------------- |
| `tasks.list`     | List tasks with optional filters | `status`, `assigned_to`, `priority`, `record_ids`                      |
| `tasks.get`      | Get a single task                | `task_id`                                                              |
| `tasks.create`   | Create a new task                | `title`, `priority`, `status`, `assigned_to`, `due_date`, `record_ids` |
| `tasks.update`   | Update task fields               | `task_id`, `title`, `priority`, `status`, `assigned_to`, `due_date`    |
| `tasks.complete` | Mark a task as done              | `task_id`                                                              |
| `tasks.delete`   | Delete a task                    | `task_id`                                                              |

### Priority Levels

`low` `medium` `high` `urgent`

### Statuses

`todo` `in_progress` `done`

## Examples

### Create a follow-up task assigned to a team member

```json theme={null}
{
  "tool": "tasks.create",
  "params": {
    "title": "Send proposal to Acme Corp",
    "priority": "high",
    "status": "todo",
    "assigned_to": "user_abc",
    "due_date": "2026-03-28",
    "record_ids": ["rec_deal_01", "rec_contact_01"]
  }
}
```

### List overdue tasks for a user

```json theme={null}
{
  "tool": "tasks.list",
  "params": {
    "assigned_to": "user_abc",
    "status": "todo"
  }
}
```

### Complete a task

```json theme={null}
{
  "tool": "tasks.complete",
  "params": {
    "task_id": "task_xyz789"
  }
}
```