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, import it as a subflow, and RUN it. This is CLI parity with the editor's Publish action, which publishes the saved flow document.

Publishing compiles the flow, so the published id is directly runnable — it is what "axiom flow run" takes, what GET /flows/<handle>/<flow>/versions hands consumers, and what /v1/flows/invoke accepts. If the flow does not compile, the publish fails with the compiler's error and nothing is published.

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 COPIES the flow: it mints a new, frozen marketplace artifact and leaves your draft private and editable, still listed in the editor's File ▸ Open. The published copy can never be edited or unpublished — to iterate, edit your draft and publish it again, which mints a new snapshot.

Requires a prior "axiom login".

Usage#

axiom flow publish <graph-id> [flags]

Flags#

See also#

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