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

# kolena_agents.types.agent_run

## `AgentRun`

AgentRun

### `agent_id`

```python theme={null}
agent_id: StrictInt
```

The ID of the Agent being run.

### `run_id`

```python theme={null}
run_id: StrictInt
```

The ID of this Agent Run.

### `user_defined_id`

```python theme={null}
user_defined_id: Optional[StrictStr]
```

### `created`

```python theme={null}
created: datetime
```

When this Run was created, formatted as an ISO 8601 timestamp (e.g. `2025-12-31T10:15:45+00:00`)

### `updated`

```python theme={null}
updated: datetime
```

When this Run was last updated, formatted as an ISO 8601 timestamp (e.g. `2025-12-31T10:15:45+00:00`)

### `completed`

```python theme={null}
completed: Optional[datetime]
```

### `files`

```python theme={null}
files: List[StrictStr]
```

List of filenames included in this Run.

### `run_url`

```python theme={null}
run_url: StrictStr
```

Link to this Run on [agents.kolena.com](https://agents.kolena.com/).

### `order`

```python theme={null}
order: List[StrictStr]
```

The order of Prompts in this Agent. When results are ready for a Prompt, it will be included in the `data` object.

### `data`

```python theme={null}
data: Dict[str, AgentRunResult]
```

The output data from completed Prompts, keyed on Prompt name.  Once a Prompt is completed (status `success` or `failed`), it will be included in this object. Any `running` prompts are omitted.

### `status`

```python theme={null}
status: AgentRunStatus
```

The status of this Run.

### `usage`

```python theme={null}
usage: Optional[AgentCreditUsage] = None
```

## `AgentRunStatus`

AgentRunStatus

### `RUNNING`

```python theme={null}
RUNNING = 'running'
```

### `SUCCESS`

```python theme={null}
SUCCESS = 'success'
```

### `FAILED`

```python theme={null}
FAILED = 'failed'
```

## `ListAgentRunsResponse`

ListAgentRunsResponse

### `runs`

```python theme={null}
runs: List[AgentRun]
```

The fetched page of Runs from this Agent.

### `total_pages`

```python theme={null}
total_pages: StrictInt
```

The total number of pages of Runs. Use the request arguments `page_number` and `page_size` to control which Runs are fetched.

### `page_number`

```python theme={null}
page_number: StrictInt
```

The number of the fetched page.

### `page_size`

```python theme={null}
page_size: StrictInt
```

The page size, i.e. number of Runs, fetched.

## `OutputFormat`

OutputFormat

### `PDF`

```python theme={null}
PDF = 'pdf'
```

### `DOCX`

```python theme={null}
DOCX = 'docx'
```

### `XLSX`

```python theme={null}
XLSX = 'xlsx'
```

### `XLSM`

```python theme={null}
XLSM = 'xlsm'
```

### `CSV`

```python theme={null}
CSV = 'csv'
```


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