:original_name: swr_02_0026.html

.. _swr_02_0026:

Creating an Organization
========================

Function
--------

Create an organization.

URI
---

POST /v2/manage/namespaces

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

.. table:: **Table 1** 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. |
   +-----------------+-----------------+-----------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+

.. table:: **Table 2** Request body parameter

   +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | 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. |
   +-----------+-----------+--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Response Parameters
-------------------

N/A

Example Request
---------------

.. code-block:: text

   POST https://{endpoint}/v2/manage/namespaces

   {
     "namespace" : "group"
   }

Example Response
----------------

N/A

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

+-------------+----------------------------------------------------------------------------------+
| Status Code | Description                                                                      |
+=============+==================================================================================+
| 201         | Creation successful.                                                             |
+-------------+----------------------------------------------------------------------------------+
| 400         | The request is incorrect or the number of organizations exceeds the upper limit. |
+-------------+----------------------------------------------------------------------------------+
| 401         | Authentication failed.                                                           |
+-------------+----------------------------------------------------------------------------------+
| 409         | The resource already exists.                                                     |
+-------------+----------------------------------------------------------------------------------+
| 500         | Internal error.                                                                  |
+-------------+----------------------------------------------------------------------------------+