---
title: "axiom invoke"
description: "Invoke a published node directly and print its raw JSON response"
category: reference
surfaces: [cli]
related: [reference/cli/axiom]
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 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:

```text
--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".

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

## Usage

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

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for invoke |
| `--input` |  | string |  | Inline JSON input, e.g. --input '{"value":"hi"}' |
| `--input-file` |  | string |  | Path to a file containing JSON input |
| `--timeout` |  | uint32 | `30` | Seconds to wait for the node to respond |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages