vault/website/source/docs/commands/kv/destroy.html.md

layout, page_title, sidebar_title, sidebar_current, description

layout	page_title	sidebar_title	sidebar_current	description
docs	kv destroy - Command	<code>destroy</code>	docs-commands-kv-destroy	The "kv destroy" command permanently removes the specified version data for the provided key and version numbers from the key-value store.

kv destroy

~> NOTE: This is a K/V Version 2 secrets engine command, and not available for Version 1.

The secrets enable command permanently removes the specified versions' data from the key/value secrets engine. If no key exists at the path, no action is taken.

Examples

Destroy version 11 of the key "creds":

$ vault kv destroy -versions=11 secret/creds
Success! Data written to: secret/destroy/creds

Usage

There are no flags beyond the standard set of flags included on all commands.

Output Options

• -format (string: "table") - Print the output in the given format. Valid formats are "table", "json", or "yaml". This can also be specified via the VAULT_FORMAT environment variable.

Command Options

• -versions ([]int: <required>) - The versions to destroy. Their data will be permanently deleted.