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

# task_workers

# `prefect.server.api.task_workers`

## Functions

### `read_task_workers` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/task\_workers.py#L18](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/task_workers.py#L18)</sup>

```python theme={null}
read_task_workers(task_worker_filter: Optional[TaskWorkerFilter] = Body(default=None, description='The task worker filter', embed=True)) -> List[TaskWorkerResponse]
```

Read active task workers. Optionally filter by task keys.

For more information, see [https://www.prefect.io/docs/v3/how-to-guides/workflows/run-background-tasks](https://www.prefect.io/docs/v3/how-to-guides/workflows/run-background-tasks).

## Classes

### `TaskWorkerFilter` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/task\_workers.py#L13](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/task_workers.py#L13)</sup>