Skip to content

Commit

Permalink
[DOCUMENT] Updated Change
Browse files Browse the repository at this point in the history
  • Loading branch information
samirpatil2000 authored Jan 25, 2025
1 parent 04e7537 commit 2c4fb41
Showing 1 changed file with 5 additions and 8 deletions.
13 changes: 5 additions & 8 deletions website/content/api-docs/secret/kv/kv-v2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -511,25 +511,22 @@ this command.

To list secrets for KV v2, a user must have a policy granting them the list capability on this `/metadata/` path - even if all the rest of their interactions with the KV v2 are via the `/data/` APIs. Access to at least list the `/metadata/` path should typically also be granted.

| Method | Path |
|:-------|:-------------------------------------|
| `LIST` | `/:secret-mount-path/metadata/:path` |
| Method | Path |
|:-------|:------------------------------------------|
| `GET` | `/:secret-mount-path/metadata/?list=true` |

### Parameters

- `secret-mount-path` `(string: <required>)` - The path to the KV mount containing
the secret to list, such as `secret`. This is specified as part of the URL.

- `path` `(string: <required>)` – Specifies the path of the secrets to list.
This is specified as part of the URL.

### Sample request

```shell-session
$ curl \
--header "X-Vault-Token: ..." \
--request LIST \
https://127.0.0.1:8200/v1/secret/metadata/my-secret
--request GET \
https://127.0.0.1:8200/v1/secret/metadata/?list=true
```

### Sample response
Expand Down

0 comments on commit 2c4fb41

Please sign in to comment.