open-consul/website/pages/docs/commands/namespace/delete.mdx

---
layout: docs
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 16:14:56 +00:00			`---`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`layout: docs`
			`page_title: 'Commands: Namespace Delete'`
remove 'sidebar_current' from frontmatter 2020-04-13 18:40:26 +00: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 16:14:56 +00: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 22:13:18 +00: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 16:14:56 +00: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 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'`
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
			`## Examples`

			`Delete a Namespace:`

update dependencies 2020-05-19 18:32:38 +00: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 16:14:56 +00:00			`$ consul namespace delete "team-1"`
			```