Public beta — not for production use. Data may be wiped at any time. Questions? Contact us.
Documentation menu

axiom flow publish

Publish a flow document to the public marketplace

View as Markdown
<!-- 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 publish

Publish a flow document to the public marketplace

Publish a flow document — the GRAPH artifact id printed by "axiom flow save" — to the public marketplace.

Publishing sets the flow's visibility to MARKETPLACE_FREE: every Axiom tenant can then discover it (it becomes searchable), fork it, and import it as a subflow. This is CLI parity with the editor's Publish action, which publishes the saved flow document.

Pass the id from "axiom flow save", NOT the id from "axiom flow compile": the compile id is a runtime snapshot (COMPILED_GRAPH) that never appears in catalog search or saved-flows listings, so publishing it would strand the flow invisible. The publish endpoint rejects a compiled-snapshot id for that reason.

axiom flow save    my-flow.flow.yaml   # prints the GRAPH document id
axiom flow publish 01J…                # publish that id
axiom flow publish 01J… --yes          # skip the prompt (CI)

Publishing is immutable — a published flow cannot be edited or unpublished. To iterate, edit the flow and "axiom flow save" a new document, then publish it.

Requires a prior "axiom login".

Usage

axiom flow publish <graph-id> [flags]

Flags

FlagShorthandTypeDefaultDescription
--help-hboolhelp for publish
--jsonboolEmit a single JSON result object
--yes-yboolSkip the confirmation prompt (for CI and scripted use)

See also

  • axiom flow — Author and compile flows (graphs of published nodes)
Related