consul/website/content/commands/acl/policy/delete.mdx

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

# Consul ACL Policy Delete

Command: `consul acl policy delete`

Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/policy/:id](https://www.consul.io/api-docs/acl/policies#delete-a-policy)

The `acl policy delete` command deletes a policy. Policies may be deleted by their ID or by name.

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

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

## Usage

Usage: `consul acl policy delete [options]`

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'

#### Command Options

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

- `-name=<string>` - The Name of the policy to delete.

#### Enterprise Options

@include 'http_api_namespace_options.mdx'

@include 'http_api_partition_options.mdx'

## Examples

Delete a policy:

```shell-session
$ consul acl policy delete -id 35b8
Policy "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully
```

Delete a policy by name:

```shell-session
$ consul acl policy delete -name acl-replication
Policy "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully
```
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +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 Policy Delete'`
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`---`

			`# Consul ACL Policy Delete`

			Command: `consul acl policy delete`

Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 17:40:11 +00:00			`Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/policy/:id](https://www.consul.io/api-docs/acl/policies#delete-a-policy)`

docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			The `acl policy delete` command deletes a policy. Policies may be deleted by their ID or by name.

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`
			`[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)`
			`are not supported from commands, but may be from the corresponding HTTP endpoint.`

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

docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`## Usage`

			Usage: `consul acl policy delete [options]`

			`#### API Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@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'`
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00
			`#### Command Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			- `-id=<string>` - The ID of the policy to delete. It may be specified as a
			`unique ID prefix but will error if the prefix matches multiple policy IDs.`
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			- `-name=<string>` - The Name of the policy to delete.
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00
Add Namespace support to the API module and the CLI commands (#6874) Also update the Docs and fixup the HTTP API to return proper errors when someone attempts to use Namespaces with an OSS agent. Add Namespace HTTP API docs Make all API endpoints disallow unknown fields 2019-12-06 16:14:56 +00:00			`#### Enterprise Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_namespace_options.mdx'`
Add Namespace support to the API module and the CLI commands (#6874) Also update the Docs and fixup the HTTP API to return proper errors when someone attempts to use Namespaces with an OSS agent. Add Namespace HTTP API docs Make all API endpoints disallow unknown fields 2019-12-06 16:14:56 +00:00
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'`

docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`## Examples`

			`Delete a policy:`

update dependencies 2020-05-19 18:32:38 +00:00			```shell-session
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`$ consul acl policy delete -id 35b8`
			`Policy "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully`
			```

			`Delete a policy by name:`

update dependencies 2020-05-19 18:32:38 +00:00			```shell-session
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`$ consul acl policy delete -name acl-replication`
			`Policy "35b8ecb0-707c-ee18-2002-81b238b54b38" deleted successfully`
			```