open-consul/website/content/commands/acl/token/delete.mdx

---
layout: commands
page_title: 'Commands: ACL Token Delete'
---

# Consul ACL Token Delete

Command: `consul acl token delete`

Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/token/:AccessorID](/api-docs/acl/tokens#delete-a-token)

The `acl token delete` command deletes a token.

The table below shows this command's [required ACLs](/api#authentication). Configuration of
[blocking queries](/api-docs/features/blocking) and [agent caching](/api-docs/features/caching)
are not supported from commands, but may be from the corresponding HTTP endpoint.

| ACL Required |
| ------------ |
| `acl:write`  |

## Usage

Usage: `consul acl token delete [options]`

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'

#### Command Options

- `-id=<string>` - The ID of the token to delete. It may be specified as a
  unique ID prefix but will error if the prefix matches multiple token IDs.

#### Enterprise Options

@include 'http_api_namespace_options.mdx'

@include 'http_api_partition_options.mdx'

## Examples

Delete a token:

```shell-session
$ consul acl token delete -id 35b8
Token "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully
```
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`---`
docs: update structure (#8506) - moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page 2020-09-01 15:14:13 +00:00			`layout: commands`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`page_title: 'Commands: ACL Token Delete'`
			`---`

			`# Consul ACL Token Delete`

			Command: `consul acl token delete`

Fixed absolute links to HTTP apis. 2022-01-11 13:26:58 +00:00			`Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/token/:AccessorID](/api-docs/acl/tokens#delete-a-token)`
Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 17:40:11 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			The `acl token delete` command deletes a token.

Added ACL requirements for CLI commands 2022-01-10 21:44:56 +00:00			`The table below shows this command's [required ACLs](/api#authentication). Configuration of`
website: redirect /api to /api-docs (#12660) 2022-03-30 21:16:26 +00:00			`[blocking queries](/api-docs/features/blocking) and [agent caching](/api-docs/features/caching)`
Added ACL requirements for CLI commands 2022-01-10 21:44:56 +00:00			`are not supported from commands, but may be from the corresponding HTTP endpoint.`

			`\| ACL Required \|`
			`\| ------------ \|`
			\| `acl:write` \|

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`## Usage`

			Usage: `consul acl token delete [options]`

			`#### API Options`

			`@include 'http_api_options_client.mdx'`
docs rendering 2020-04-07 23:56:08 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_server.mdx'`

			`#### Command Options`

			- `-id=<string>` - The ID of the token to delete. It may be specified as a
			`unique ID prefix but will error if the prefix matches multiple token IDs.`

			`#### Enterprise Options`

			`@include 'http_api_namespace_options.mdx'`

Website fixups for admin partitions (#11842) * Website fixups for admin partitions Signed-off-by: Mark Anderson <manderson@hashicorp.com> 2021-12-15 01:55:21 +00:00			`@include 'http_api_partition_options.mdx'`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`## Examples`

			`Delete a token:`

update dependencies 2020-05-19 18:32:38 +00:00			```shell-session
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`$ consul acl token delete -id 35b8`
			`Token "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully`
			```