consul/website/content/commands/acl/auth-method/delete.mdx

---
layout: commands
page_title: 'Commands: ACL Auth Method Delete'
---

# Consul ACL Auth Method Delete

Command: `consul acl auth-method delete`

Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/auth-method/:name](/api-docs/acl/auth-methods#delete-an-auth-method)

The `acl auth-method delete` command deletes an auth method.

The table below shows this command's [required ACLs](/api-docs/api-structure#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 auth-method delete [options]`

#### Command Options

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

#### Enterprise Options

@include 'http_api_partition_options.mdx'

@include 'http_api_namespace_options.mdx'

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'

## Examples

Delete an auth method:

```shell-session
$ consul acl auth-method delete -name minikube
Auth-method "minikube" 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 Auth Method Delete'`
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`---`

			`# Consul ACL Auth Method Delete`

			Command: `consul acl auth-method delete`

Fixed absolute links to HTTP apis. 2022-01-11 13:26:58 +00:00			`Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/auth-method/:name](/api-docs/acl/auth-methods#delete-an-auth-method)`
Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 17:40:11 +00:00
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			The `acl auth-method delete` command deletes an auth method.

docs: fix api docs anchor links 2022-10-18 19:49:07 +00:00			`The table below shows this command's [required ACLs](/api-docs/api-structure#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` \|

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

			Usage: `consul acl auth-method delete [options]`

			`#### Command Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			- `-name=<string>` - The Name of the auth method 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`

docs: show CLI cmd-specific opts before general opts Applied to all remaining CLI commands. 2022-07-27 06:17:11 +00:00			`@include 'http_api_partition_options.mdx'`

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
docs: show CLI cmd-specific opts before general opts Applied to all remaining CLI commands. 2022-07-27 06:17:11 +00:00			`#### API Options`

			`@include 'http_api_options_client.mdx'`

			`@include 'http_api_options_server.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
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 21:11:23 +00:00			`## Examples`

			`Delete an auth method:`

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 auth-method delete -name minikube`
			`Auth-method "minikube" deleted successfully`
			```