vault/website/source/api/system/revoke.html.md

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

/sys/revoke

The /sys/revoke endpoint is used to revoke secrets.

Revoke Secret

This endpoint revokes a secret immediately.

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

Parameters

• lease_id (string: <required>) – Specifies the ID of the lease to revoke.

Sample Payload

{
  "lease_id": "postgresql/creds/readonly/abcd-1234..."
}

Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request PUT \
    --data @payload.json \
    https://vault.rocks/v1/sys/revoke