33 lines
781 B
Markdown
33 lines
781 B
Markdown
---
|
|
layout: "http"
|
|
page_title: "HTTP API: /sys/revoke-prefix"
|
|
sidebar_current: "docs-http-lease-revoke-prefix"
|
|
description: |-
|
|
The `/sys/revoke-prefix` endpoint is used to revoke secrets or tokens based on prefix.
|
|
---
|
|
|
|
# /sys/revoke-prefix
|
|
|
|
<dl>
|
|
<dt>Description</dt>
|
|
<dd>
|
|
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.
|
|
</dd>
|
|
|
|
<dt>Method</dt>
|
|
<dd>PUT</dd>
|
|
|
|
<dt>URL</dt>
|
|
<dd>`/sys/revoke-prefix/<path prefix>`</dd>
|
|
|
|
<dt>Parameters</dt>
|
|
<dd>None</dd>
|
|
|
|
<dt>Returns</dt>
|
|
<dd>A `204` response code.
|
|
</dd>
|
|
</dl>
|