axiom invoke#

Invoke a published node directly and print its raw JSON response

Invoke a published node directly — the same endpoint "axiom push" prints after a successful push — and print its raw JSON response body to stdout.

Provide the node's input JSON with exactly one of:

--input '<json>'      inline JSON, e.g. --input '{"text":"hello world"}'
--input-file <path>   read JSON from a file
piped stdin            echo '{"text":"hello world"}' | axiom invoke ...

When @version is omitted, the most recently published version is used.

Input size: the request body is capped at 16 MiB (the platform run-payload cap). Larger inputs are rejected before the node runs. Binary inputs (e.g. an image for a resize/convert node) are base64-encoded inside the JSON, which inflates them by ~33%, so a raw file up to ~12 MiB fits. A typical phone photo (1–5 MB) is well within the limit and does not need to be pre-shrunk.

The response body is printed to stdout exactly as returned, so it pipes cleanly into jq; all diagnostics and status messages go to stderr. Exits non-zero on a node error or non-2xx HTTP status, 0 on success. Requires a prior "axiom login".

axiom invoke nadia/summarizer/Summarize --input '{"text":"hello world"}'

Usage#

axiom invoke <handle>/<package>/<node>[@version] [flags]

Flags#

See also#

• axiom — Axiom CLI — build and push node packages