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

# task_run

# `prefect.runtime.task_run`

Access attributes of the current task run dynamically.

Note that if a task run cannot be discovered, all attributes will return empty values.

You can mock the runtime attributes for testing purposes by setting environment variables
prefixed with `PREFECT__RUNTIME__TASK_RUN`.

Available attributes:

* `id`: the task run's unique ID
* `name`: the name of the task run
* `tags`: the task run's set of tags
* `parameters`: the parameters the task was called with
* `run_count`: the number of times this task run has been run
* `task_name`: the name of the task

## Functions

### `get_id` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L89](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L89)</sup>

```python theme={null}
get_id() -> str | None
```

### `get_tags` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L95](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L95)</sup>

```python theme={null}
get_tags() -> list[str]
```

### `get_run_count` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L103](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L103)</sup>

```python theme={null}
get_run_count() -> int
```

### `get_name` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L111](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L111)</sup>

```python theme={null}
get_name() -> str | None
```

### `get_task_name` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L119](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L119)</sup>

```python theme={null}
get_task_name() -> str | None
```

### `get_parameters` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L127](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L127)</sup>

```python theme={null}
get_parameters() -> dict[str, Any]
```

### `get_task_run_api_url` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L135](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L135)</sup>

```python theme={null}
get_task_run_api_url() -> str | None
```

### `get_task_run_ui_url` <sup>[https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task\_run.py#L143](https://github.com/PrefectHQ/prefect/blob/main/src/prefect/runtime/task_run.py#L143)</sup>

```python theme={null}
get_task_run_ui_url() -> str | None
```