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

# task_runs

# `prefect.server.api.ui.task_runs`

## Functions

### `read_dashboard_task_run_counts` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task\_runs.py#L43](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task_runs.py#L43)</sup>

```python theme={null}
read_dashboard_task_run_counts(task_runs: schemas.filters.TaskRunFilter, flows: Optional[schemas.filters.FlowFilter] = None, flow_runs: Optional[schemas.filters.FlowRunFilter] = None, deployments: Optional[schemas.filters.DeploymentFilter] = None, work_pools: Optional[schemas.filters.WorkPoolFilter] = None, work_queues: Optional[schemas.filters.WorkQueueFilter] = None, db: PrefectDBInterface = Depends(provide_database_interface)) -> List[TaskRunCount]
```

### `read_task_run_counts_by_state` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task\_runs.py#L165](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task_runs.py#L165)</sup>

```python theme={null}
read_task_run_counts_by_state(flows: Optional[schemas.filters.FlowFilter] = None, flow_runs: Optional[schemas.filters.FlowRunFilter] = None, task_runs: Optional[schemas.filters.TaskRunFilter] = None, deployments: Optional[schemas.filters.DeploymentFilter] = None, db: PrefectDBInterface = Depends(provide_database_interface)) -> schemas.states.CountByState
```

### `read_task_run_with_flow_run_name` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task\_runs.py#L183](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task_runs.py#L183)</sup>

```python theme={null}
read_task_run_with_flow_run_name(task_run_id: UUID = Path(..., description='The task run id', alias='id'), db: PrefectDBInterface = Depends(provide_database_interface)) -> schemas.ui.UITaskRun
```

Get a task run by id.

## Classes

### `TaskRunCount` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task\_runs.py#L28](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task_runs.py#L28)</sup>

**Methods:**

#### `model_validate_list` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/\_internal/schemas/bases.py#L56](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/_internal/schemas/bases.py#L56)</sup>

```python theme={null}
model_validate_list(cls, obj: Any) -> list[Self]
```

#### `reset_fields` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/\_internal/schemas/bases.py#L85](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/_internal/schemas/bases.py#L85)</sup>

```python theme={null}
reset_fields(self: Self) -> Self
```

Reset the fields of the model that are in the `_reset_fields` set.

**Returns:**

* A new instance of the model with the reset fields.

#### `ser_model` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task\_runs.py#L35](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/server/api/ui/task_runs.py#L35)</sup>

```python theme={null}
ser_model(self) -> dict[str, int]
```