:original_name: swr_02_0026.html

.. _swr_02_0026:

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

Function
--------

Create an organization.

URI
---

POST /v2/manage/namespaces

Request
-------

-  Request parameters

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

-  Example request

   Create an organization named **group**:

   .. code-block:: text

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

   Body:

   .. code-block::

      {
          "namespace": "group"
      }

Response
--------

-  Response parameters

   N/A

-  Example response

   .. code-block::

      {}

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