---
title: "axiom flow run"
description: "Invoke a compiled flow and print its result"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-flow]
last_reviewed: 2026-06-06
---

<!-- GENERATED by docs/scripts/gen-cli-reference — DO NOT EDIT.
     Source of truth: the cobra command definitions in cmd/axiom/cmd/.
     Regenerate from the repo root with: go run ./docs/scripts/gen-cli-reference -->

# axiom flow run

Invoke a compiled flow and print its result

Invoke a compiled flow — the artifact id printed by "axiom flow compile" — and
wait for the result.

Pass the start node's input as JSON with -d; the ingress transcodes it to
protobuf automatically, and the result is decoded back to JSON. Requires a
prior "axiom login".

```text
axiom flow run 01J… -d '{"value":"hello"}'
```

## Usage

```sh
axiom flow run <artifact-id> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--data` | `-d` | string | `{}` | JSON input for the start node, e.g. -d '{"value":"hi"}' |
| `--help` | `-h` | bool |  | help for run |
| `--json` |  | bool |  | Emit the full JSON response |
| `--timeout` |  | uint32 | `60` | Seconds to wait for the flow to complete |

## See also

- [axiom flow](./axiom-flow.md) — Author and compile flows (graphs of published nodes)