---
title: "axiom secret"
description: "Inspect tenant secrets (names and state — never values)"
category: reference
surfaces: [cli]
related: [reference/cli/axiom, reference/cli/axiom-secret-ls]
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 secret

Inspect tenant secrets (names and state — never values)

Inspect the tenant's secrets: which names exist and whether each is armed
for development delivery.

Secret VALUES are write- and read-protected: they are set and viewed only in
the Console (Settings → Secrets), and armed for development there too. This
command exists so you can tell "the secret is missing" apart from "it exists
but is not dev-armed" without running a flow and decoding a 403.

## Usage

```sh
axiom secret [flags]
axiom secret [command]
```

## Flags

| Flag | Shorthand | Type | Default | Description |
|---|---|---|---|---|
| `--help` | `-h` | bool |  | help for secret |

## Subcommands

| Command | Description |
|---|---|
| [axiom secret ls](./axiom-secret-ls.md) | List secret names and their dev-arming state |

## See also

- [axiom](./axiom.md) — Axiom CLI — build and push node packages
- [axiom secret ls](./axiom-secret-ls.md) — List secret names and their dev-arming state