---
title: "axiom push"
description: "Push the package to the Axiom platform (tenant-private)"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, guides/use-interactive-api-docs, guides/manage-secrets]
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 push

Push the package to the Axiom platform (tenant-private)

Validate the package locally, then push it to the Axiom platform.

Unlike publishing, a pushed package is only visible to your own tenant — it
does not appear in the public marketplace. You can push the same version
repeatedly; each push overwrites the previous one. This lets you iterate on
code and test it deployed before making it public.

When you are satisfied with the package, publish it through the Axiom UI to
make it available to others as an immutable versioned release.

Requires a prior "axiom login". The current HEAD must be pushed to the remote.

## Usage

```sh
axiom push [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for push |
| `--json` |  | bool |  | Emit a single JSON result object instead of human-readable progress output |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- Guide: [Use the interactive API docs](../../guides/use-interactive-api-docs.md)
- Guide: [Manage secrets in a flow](../../guides/manage-secrets.md)