From cb3f8dca00317139feddc0a63d57a0e22d5a55b9 Mon Sep 17 00:00:00 2001 From: Eleonore Carpentier Date: Wed, 30 Jul 2025 11:27:03 +0200 Subject: [PATCH 1/3] Add documentation for new secret list parameter --- .../vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx index 317652d9e2..687e526d06 100644 --- a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx +++ b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx @@ -523,13 +523,15 @@ the secret to list, such as `secret`. This is specified as part of the URL. - `path` `(string: )` – Specifies the path of the secrets to list. This is specified as part of the URL. +- `exclude_deleted` `(bool: false)` – If set to true, only non-deleted entries will be returned. + ### Sample request ```shell-session $ curl \ --header "X-Vault-Token: ..." \ --request LIST \ - https://127.0.0.1:8200/v1/secret/metadata/my-secret + https://127.0.0.1:8200/v1/secret/metadata/my-secret?exclude_deleted=false ``` ### Sample response From ca8c4668708774a8c130d7dbc4390cf035724ba3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?El=C3=A9onore=20Carpentier?= Date: Mon, 4 Aug 2025 09:34:12 +0200 Subject: [PATCH 2/3] Apply suggestion from @schavis Co-authored-by: Sarah Chavis <62406755+schavis@users.noreply.github.com> --- content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx index 687e526d06..d5dd96dcc5 100644 --- a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx +++ b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx @@ -523,7 +523,7 @@ the secret to list, such as `secret`. This is specified as part of the URL. - `path` `(string: )` – Specifies the path of the secrets to list. This is specified as part of the URL. -- `exclude_deleted` `(bool: false)` – If set to true, only non-deleted entries will be returned. +- `exclude_deleted` `(bool: false)` – Only return non-deleted entries. ### Sample request From 1d9dc46898f3fab867c2a4b71728a48ee418ff44 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?El=C3=A9onore=20Carpentier?= Date: Mon, 4 Aug 2025 09:34:18 +0200 Subject: [PATCH 3/3] Apply suggestion from @schavis Co-authored-by: Sarah Chavis <62406755+schavis@users.noreply.github.com> --- content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx index d5dd96dcc5..4dceffd655 100644 --- a/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx +++ b/content/vault/v1.21.x (rc)/content/api-docs/secret/kv/kv-v2.mdx @@ -531,7 +531,7 @@ the secret to list, such as `secret`. This is specified as part of the URL. $ curl \ --header "X-Vault-Token: ..." \ --request LIST \ - https://127.0.0.1:8200/v1/secret/metadata/my-secret?exclude_deleted=false + https://${VAULT_ADDR}/v1/secret/metadata/my-secret?exclude_deleted=false ``` ### Sample response