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

# tai runs

> List and prune the platform runs index.

List and prune the platform runs index.

```console theme={null}
$ tai runs [OPTIONS] COMMAND [ARGS]...
```

## `tai runs list`

List platform runs, newest first, filtered by the given flags.

Example: `tai runs list --preset support --outcome error`

```console theme={null}
$ tai runs list [OPTIONS]
```

| Option                        | Description                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------- |
| `--preset` `<str>`      | Filter to one preset name.                                                      |
| `--version` `<int>`     | Filter to one preset version.                                                   |
| `--user` `<str>`        | Filter to one run user (attribution user identity).                             |
| `--session` `<str>`     | Filter to one run session/thread (attribution session identity).                |
| `--interaction` `<str>` | Filter to one park lifecycle by interaction id (the parked run and its resume). |
| `--outcome` `<str>`     | Filter to one outcome: running, success, error, parked, or aborted.             |
| `--from` `<str>`        | Inclusive lower bound on the run start as an ISO-8601 instant.                  |
| `--to` `<str>`          | Inclusive upper bound on the run start as an ISO-8601 instant.                  |
| `--page` `<int>`        | Page number (1-based).                                                          |
| `--page-size` `<int>`   | Rows per page.                                                                  |
| `--json` / `--no-json`        | Emit raw JSON instead of human tables.                                          |

## `tai runs prune`

Delete runs-index rows older than the configured retention window.

A deployment-wide destructive purge (admin only), mirroring the checkpoint sweep.

Example: `tai runs prune`

```console theme={null}
$ tai runs prune [OPTIONS]
```

| Option                 | Description                            |
| ---------------------- | -------------------------------------- |
| `--json` / `--no-json` | Emit raw JSON instead of human tables. |