# geni workflow execution (/cli/resource/workflow/execution)



```sh
geni workflow execution <executionId> [flags]
```

Inspects a single execution: status, runtime, the parsed run output, and (with `--logs`) its logs. Add `--input` or `--thread` to print the trigger payload or the step-by-step thread, or `--download` to write the whole trace to disk for offline debugging.

## Synopsis [#synopsis]

```sh
geni workflow execution exec_01HX --logs
geni workflow execution exec_01HX --thread
geni workflow execution exec_01HX --download
geni workflow execution exec_01HX --workflow wf_01HX --json
```

| Arg / Flag         | Notes                                                            |
| ------------------ | ---------------------------------------------------------------- |
| `<executionId>`    | The execution to inspect.                                        |
| `--workflow <id>`  | Workflow id. Omit to use the marker in `--dir`.                  |
| `--dir <path>`     | Resource directory for id resolution. Defaults to cwd.           |
| `--logs`           | Include the execution logs.                                      |
| `--input`          | Include the trigger input payload.                               |
| `--thread`         | Include the step-by-step thread (every step the run took).       |
| `--download [dir]` | Write the full trace to `<dir>/<id>/`. Defaults to `executions`. |
| `--json`           | Machine-readable output.                                         |

## Downloading a full trace [#downloading-a-full-trace]

`--download` writes whatever the run persisted into `<dir>/<id>/`, the same layout the cloud agent produces:

```
executions/exec_01HX/
  run.json      parsed run output
  logs.txt      raw logs
  input.json    the trigger payload that started the run
  thread.json   every step the run took (the agent conversation for agent workflows)
```

This is the way to debug an agent workflow that misbehaved: read `thread.json` to see exactly what the agent did, step by step.

List a workflow's executions with [`geni workflow executions`](/cli/resource/workflow/executions).