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.

Name the flow — "<handle>/<flow-name>", optionally "@<version>" — or give the artifact id "axiom flow compile" prints (also accepted by "axiom flow run"). PREFER THE NAME: it always resolves to the flow's CURRENT published graph, while an artifact id names one published version and goes stale on the next publish.

axiom inspect flow nadia/cron-explainer | jq .
axiom inspect flow nadia/cron-explainer@1.2.0 --schema
axiom inspect flow 01HQY5K7XWZ6N8R2BTEF4... | jq .

--schema prints ONLY the flow's two facade messages (fields + descriptions) as {"input": …, "output": …}, instead of the whole OpenAPI document. Use it to read or verify a flow's typed contract without walking the spec's nesting:

axiom inspect flow <artifact-id> --schema
axiom inspect flow <artifact-id> --schema | jq '.input.properties | to_entries[] | select(.value.description == null)'

Usage#

axiom inspect flow <flow-name|artifact-id> [flags]

Flags#

See also#

• axiom inspect — Print the compiled JSON Schema for a node or flow (the shape an invoke must satisfy)