# Tasks

View and manage scheduled outreach tasks

## List tasks

 - [GET /flows/api/tasks](https://api.getsales.io/bundled/tasks/listtasks.md): Returns all tasks for the current team with filtering and pagination. Tasks represent individual outreach actions within automation flows, including LinkedIn actions (connect requests, messages, profile visits), email sends, phone calls, CRM updates, delays, conditions, and custom actions.

Filter by status to see in-progress, completed, failed, or skipped tasks. Filter by type to find specific action types. Filter by flow_uuid to see tasks within a specific automation. Filter by lead_uuid or sender_profile_uuid for targeted task searches.

## Get task details

 - [GET /flows/api/tasks/{uuid}](https://api.getsales.io/bundled/tasks/gettask.md): Retrieves full details for a specific task by UUID, including payload, execution history, and all metadata. Use this to inspect a task's configuration, status, and results.

## Complete a task

 - [PUT /flows/api/tasks/{uuid}/complete](https://api.getsales.io/bundled/tasks/completetask.md): Marks a task as complete (closed). Only works on manual or custom tasks that are currently in_progress, delegated, or paused. Use this endpoint to manually complete tasks that don't have automatic completion logic.

## Cancel a task

 - [PUT /flows/api/tasks/{uuid}/cancel](https://api.getsales.io/bundled/tasks/canceltask.md): Cancels a task by changing its status to canceled. Works on tasks that are currently in_progress, delegated, or paused. Cannot cancel already closed or failed tasks.

## Get task metrics

 - [POST /flows/api/tasks/metrics](https://api.getsales.io/bundled/tasks/gettaskmetrics.md): Retrieve aggregated metrics and statistics for tasks. Returns counts of tasks by status, type, and performance metrics. Useful for dashboards, reports, and monitoring automation performance.

## Get task schedule

 - [GET /flows/api/tasks/schedule](https://api.getsales.io/bundled/tasks/gettaskschedule.md): Retrieve the upcoming task schedule for a specific sender profile and date. Returns tasks scheduled to execute on that day, grouped by time. Useful for understanding daily execution volume and planning.