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

# Run

> A Run accepted by the control plane.

```python theme={null}
class Run[Result]
```

```python theme={null}
name: str
id: str
created_by: str | None
created_at: datetime | None
updated_at: datetime | None
status: RunStatus
error_message: str | None
```

## `root_call`

<sub>property</sub>

```python theme={null}
root_call: str
```

Resource name of the root of this Run's Call tree.

## `refresh`

<sub>method</sub>

```python theme={null}
def refresh() -> Run[Result]
```

Fetch the latest durable state of this Run.

## `wait`

<sub>method</sub>

```python theme={null}
def wait(timeout: float | None = None) -> Result
```

Wait up to `timeout` seconds for the result.

`None` waits indefinitely and `0` checks once. Raises TimeoutError
if the Run is unfinished at the deadline, and RunFailed if it did not
complete.

## `cancel`

<sub>method</sub>

```python theme={null}
def cancel() -> Run[Result]
```

Request cancellation of this Run.

## `get_url`

<sub>method</sub>

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

The root Call's URL (`Call.get_url`).

## `calls`

<sub>method</sub>

```python theme={null}
async def calls(*, page_size: int | None = None) -> builtins.list[Call[object]]
```

List every Call in this Run's tree.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.