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

---
layout: commands
page_title: 'Commands: ACL Auth Method Delete'
description: |
  The `consul acl auth-method delete` command deletes an individually specified auth method.
---

# Consul ACL Auth Method Delete

Command: `consul acl auth-method delete`

Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/auth-method/:name](/consul/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](/consul/api-docs/api-structure#authentication). Configuration of
[blocking queries](/consul/api-docs/features/blocking) and [agent caching](/consul/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 16:11:23 -05: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 10:14:13 -05:00			`layout: commands`
intro and api navigation converted 2020-04-07 14:55:19 -04:00			`page_title: 'Commands: ACL Auth Method Delete'`
docs: CLI page descriptions for automated checker (#16056) * ACL * ACL * Catalog * consul config * consul connect * top-level updates * consul intention * consul kv * consul namespace * consul peering * consul peering delete * consul services * consul snapshot * consul tls * consul acl auth-method * acl binding-rule * acl policy * acl role * acl token * fix * standardization * Update website/content/commands/snapshot/save.mdx Co-authored-by: Bryce Kalow <bkalow@hashicorp.com> * consul debug consul keyring Co-authored-by: Bryce Kalow <bkalow@hashicorp.com> Co-authored-by: Tu Nguyen <im2nguyen@users.noreply.github.com> 2023-01-26 12:42:13 -06:00			`description: \|`
			The `consul acl auth-method delete` command deletes an individually specified auth method.
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 16:11:23 -05:00			`---`

			`# Consul ACL Auth Method Delete`

			Command: `consul acl auth-method delete`

docs: Migrate link formats (#15976) * Adding check-legacy-links-format workflow * Adding test-link-rewrites workflow * Updating docs-content-check-legacy-links-format hash * Migrating links to new format Co-authored-by: Kendall Strautman <kendallstrautman@gmail.com> 2023-01-25 10:52:43 -06:00			`Corresponding HTTP API Endpoint: [\[DELETE\] /v1/acl/auth-method/:name](/consul/api-docs/acl/auth-methods#delete-an-auth-method)`
Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 12:40:11 -05:00
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 16:11:23 -05:00			The `acl auth-method delete` command deletes an auth method.

docs: Migrate link formats (#15976) * Adding check-legacy-links-format workflow * Adding test-link-rewrites workflow * Updating docs-content-check-legacy-links-format hash * Migrating links to new format Co-authored-by: Kendall Strautman <kendallstrautman@gmail.com> 2023-01-25 10:52:43 -06:00			`The table below shows this command's [required ACLs](/consul/api-docs/api-structure#authentication). Configuration of`
			`[blocking queries](/consul/api-docs/features/blocking) and [agent caching](/consul/api-docs/features/caching)`
Added ACL requirements for CLI commands 2022-01-10 16:44:56 -05: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 16:11:23 -05:00			`## Usage`

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

			`#### Command Options`

intro and api navigation converted 2020-04-07 14:55:19 -04:00			- `-name=<string>` - The Name of the auth method to delete.
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 16:11:23 -05: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 11:14:56 -05:00			`#### Enterprise Options`

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

intro and api navigation converted 2020-04-07 14:55:19 -04: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 11:14:56 -05:00
docs: show CLI cmd-specific opts before general opts Applied to all remaining CLI commands. 2022-07-26 23:17:11 -07: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-14 17:55:21 -08:00
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 16:11:23 -05:00			`## Examples`

			`Delete an auth method:`

update dependencies 2020-05-19 14:32:38 -04:00			```shell-session
docs: add documentation for all secure acl introduction work (#5640) 2019-05-01 16:11:23 -05:00			`$ consul acl auth-method delete -name minikube`
			`Auth-method "minikube" deleted successfully`
			```