---
title: "axiom remove version"
description: "Remove a published (superseded) package version from the platform"
category: reference
surfaces: [cli]
related: [reference/cli/axiom-remove]
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 remove version

Remove a published (superseded) package version from the platform

Completely tear down one deployed package version: its marketplace
listing and registry rows, its Knative services (node + sidecar) and network
policies, and its container image.

You may remove a published version you own only while NO OTHER USER depends on
it (their flows, Instances, or clients). If your OWN resources depend on it,
they are enumerated and you must confirm the breakage. Removing a published
version retires its version number FOREVER — it can never be pushed again.

```text
axiom remove version my-handle/my-package@0.1.0
axiom remove version my-handle/my-package@0.1.0 --force   # skip the prompts (CI)
```

Requires a prior "axiom login". This cannot be undone.

## Usage

```sh
axiom remove version <package>@<version> [flags]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--force` |  | bool |  | Skip confirmation prompt |
| `--help` | `-h` | bool |  | help for version |

## See also

- [axiom remove](./axiom-remove.md) — Remove Axiom resources