vault/website/source/docs/http/sys-revoke-prefix.html.md

layout, page_title, sidebar_current, description

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

/sys/revoke-prefix

Description

Revoke 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

PUT

URL

`/sys/revoke-prefix/`

Parameters

None

Returns

A `204` response code.