upstream/vault
1
0
Fork 0
mirror of https://github.com/hashicorp/vault.git synced 2026-04-04 16:46:06 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions 11
vault/website/source/api/system/revoke-prefix.html.md
Seth Vargo f64bf8d183
/docs/http -> /api
2017-03-17 14:06:03 -04:00

1.1 KiB
Raw Blame History

layout page_title sidebar_current description
api /sys/revoke-prefix - HTTP API docs-http-system-revoke-prefix The `/sys/revoke-prefix` endpoint is used to revoke secrets or tokens based on prefix.

/sys/revoke-prefix

The /sys/revoke-prefix endpoint is used to revoke secrets or tokens based on prefix.

Revoke Prefix

This endpoint revokes all secrets (via a lease ID prefix) or tokens (via the tokens' path property) generated under a given prefix immediately. This requires sudo capability and access to it should be tightly controlled as it can be used to revoke very large numbers of secrets/tokens at once.

Method Path Produces
PUT /sys/revoke-prefix/:prefix 204 (empty body)

Parameters

  • prefix (string: <required>) – Specifies the prefix to revoke. This is specified as part of the URL.

Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request PUT \
    https://vault.rocks/v1/sys/revoke-prefix/aws/creds