---
title: "axiom inspect flow"
description: "Print a compiled flow's OpenAPI spec (its input schema)"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-inspect]
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 inspect flow

Print a compiled flow's OpenAPI spec (its input schema)

Fetch a compiled flow's OpenAPI spec (GET /graphs/{id}/openapi.json) — the
same spec the MCP's axiom_inspect returns for a flow. The artifact id is the one
"axiom flow compile" prints (also accepted by "axiom flow run").

```text
axiom inspect flow 01HQY5K7XWZ6N8R2BTEF4... | jq .
```

## Usage

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

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for flow |

## See also

- [axiom inspect](./axiom-inspect.md) — Print the compiled JSON Schema for a node or flow (the shape an invoke must satisfy)