open-vault/website/pages/docs/commands/token/revoke.mdx
Jeff Escalante 4f87851926 [website] Link Cleaning (#8205)
* update dependencies

* remove hard-coded vaultproject.io on local links

* remove 'index.html' from internal links

* remove '.html' at end of internal links

* manual review cleanup

Co-authored-by: Calvin Leung Huang <cleung2010@gmail.com>
2020-01-22 12:05:41 -08:00

54 lines
1.5 KiB
Plaintext

---
layout: docs
page_title: token revoke - Command
sidebar_title: <code>revoke</code>
description: |-
The "token revoke" revokes authentication tokens and their children. If a
TOKEN is not provided, the locally authenticated token is used.
---
# token revoke
The `token revoke` revokes authentication tokens and their children. If a TOKEN
is not provided, the locally authenticated token is used. The `-mode` flag can
be used to control the behavior of the revocation.
## Examples
Revoke a token and all the token's children:
```text
$ vault token revoke 96ddf4bc-d217-f3ba-f9bd-017055595017
Success! Revoked token (if it existed)
```
Revoke a token leaving the token's children:
```text
$ vault token revoke -mode=orphan 96ddf4bc-d217-f3ba-f9bd-017055595017
Success! Revoked token (if it existed)
```
Revoke a token by accessor:
```text
$ vault token revoke -accessor 9793c9b3-e04a-46f3-e7b8-748d7da248da
Success! Revoked token (if it existed)
```
## Usage
The following flags are available in addition to the [standard set of
flags](/docs/commands) included on all commands.
- `-accessor` `(bool: false)` - Treat the argument as an accessor instead of a
token.
- `-mode` `(string: "")` - Type of revocation to perform. If unspecified, Vault
will revoke the token and all of the token's children. If "orphan", Vault will
revoke only the token, leaving the children as orphans. If "path", tokens
created from the given authentication path prefix are deleted along with their
children.
- `-self` - Perform the revocation on the currently authenticated token.