---
url: https://docs.mochiexec.io/reference/cli/mochi_secret.md
description: Manage secrets stored in a vault.
---

# mochi secret

Manage secrets stored in a vault.

## Synopsis

Manage secrets stored in the active vault. Secrets are encrypted key-value pairs that
can be referenced inside flowfiles using the secret reference syntax (e.g. ${secret:MY\_KEY}).

The active vault is used by default; pass --vault to target a different one. Use
'vault' subcommands to create and manage vaults.

## Options

| Flag | Type | Description |
|------|------|-------------|
| `-h, --help` |  | help for secret |

## Options inherited from parent commands

| Flag | Type | Description |
|------|------|-------------|
| `-L, --log-level` | `string` | Log verbosity level (debug, info, fatal) (default "info") |
| `--sync` |  | Sync flow cache and workspaces |

## See also

* [mochi](mochi.md) — Run and organize your development tasks
* [mochi secret get](mochi_secret_get.md) — Get the value of a secret in the current vault.
* [mochi secret link](mochi_secret_link.md) — Link a name in the current vault to a secret in an external provider.
* [mochi secret list](mochi_secret_list.md) — List secrets stored in the current vault.
* [mochi secret remove](mochi_secret_remove.md) — Remove a secret from the vault.
* [mochi secret set](mochi_secret_set.md) — Set a secret in the current vault. If no value is provided, you will be prompted to enter one.
* [mochi secret unlink](mochi_secret_unlink.md) — Remove a link from the current vault, leaving the secret itself untouched.