consul/website/content/commands/namespace/delete.mdx

---
layout: commands
page_title: 'Commands: Namespace Delete'
sidebar_title: delete
---

# Consul Namespace Delete

Command: `consul namespace delete`

<EnterpriseAlert />

This `namespace delete` command deletes a namespace. This was added in Consul Enterprise 1.7.0. If
ACLs are enabled then this command will require a token with `operator:write` privileges.

## Usage

Usage: `consul namespace delete <name>`

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'

## Examples

Delete a Namespace:

```shell-session
$ consul namespace delete "team-1"
```
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: 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: Namespace Delete'`
remove 'sidebar_current' from frontmatter 2020-04-13 14:40:26 -04:00			`sidebar_title: delete`
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			`---`

			`# Consul Namespace Delete`

			Command: `consul namespace delete`

Add callouts to Enterprise features (#7548) Label all enterprise-related content with Enterprise badge/callout. Resolves #6887 Co-authored-by: Jeff Escalante <jescalan@users.noreply.github.com> 2020-04-23 15:13:18 -07:00			`<EnterpriseAlert />`

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			This `namespace delete` command deletes a namespace. This was added in Consul Enterprise 1.7.0. If
			ACLs are enabled then this command will require a token with `operator:write` privileges.

			`## Usage`

			Usage: `consul namespace delete <name>`

			`#### API Options`

intro and api navigation converted 2020-04-07 14:55:19 -04:00			`@include 'http_api_options_client.mdx'`
docs rendering 2020-04-07 19:56:08 -04:00
intro and api navigation converted 2020-04-07 14:55:19 -04:00			`@include 'http_api_options_server.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
			`## Examples`

			`Delete a Namespace:`

update dependencies 2020-05-19 14:32:38 -04:00			```shell-session
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			`$ consul namespace delete "team-1"`
			```