:original_name: swr_02_0027.html

.. _swr_02_0027:

Deleting an Organization
========================

Function
--------

Delete an organization.

URI
---

DELETE /v2/manage/namespaces/{*namespace*}

For details about parameters, see :ref:`Table 1 <swr_02_0027__tae82a09e27434bef9a38b734d798ae6c>`.

.. _swr_02_0027__tae82a09e27434bef9a38b734d798ae6c:

.. table:: **Table 1** Parameter description

   +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Parameter | Mandatory | Type   | Description                                                                                                                                                                                                                                                                                                                                        |
   +===========+===========+========+====================================================================================================================================================================================================================================================================================================================================================+
   | namespace | Yes       | String | Organization name. Enter 1 to 64 characters, starting with a lowercase letter and ending with a lowercase letter or digit. Only lowercase letters, digits, periods (.), underscores (_), and hyphens (-) are allowed. Periods, underscores, and hyphens cannot be placed next to each other. A maximum of two consecutive underscores are allowed. |
   +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Request Parameters
------------------

.. table:: **Table 2** Request header parameters

   +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Parameter       | Mandatory       | Type            | Description                                                                                                                                              |
   +=================+=================+=================+==========================================================================================================================================================+
   | Content-Type    | Yes             | String          | Message body type (format). The value can be **application/json;charset=utf-8 application/json**                                                         |
   |                 |                 |                 |                                                                                                                                                          |
   |                 |                 |                 | The default value is **application/json**.                                                                                                               |
   +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+
   | X-Auth-Token    | Yes             | String          | User token.                                                                                                                                              |
   |                 |                 |                 |                                                                                                                                                          |
   |                 |                 |                 | The token can be obtained by calling the IAM API used to obtain a user token. The value of **X-Subject-Token** in the response header is the user token. |
   +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+

Response
--------

N/A

Status Code
-----------

=========== ================================
Status Code Description
=========== ================================
204         Deleted successfully.
400         Request error.
401         Authentication failed.
404         The organization does not exist.
500         Internal error.
=========== ================================