open-vault/website/source/api/system/revoke.html.md
2017-04-27 10:47:43 -04:00

867 B
Raw Blame History

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