software-repository-container/api-ref/source/api/creating_an_organization.rst
proposalbot 4894df0e64 Changes to swr_api-ref from docs/doc-exports#415 (SWR API initial version reuplo
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: proposalbot <proposalbot@otc-service.com>
Co-committed-by: proposalbot <proposalbot@otc-service.com>
2022-11-10 10:13:15 +00:00

4.5 KiB

original_name

swr_02_0026.html

Creating an Organization

Function

Create an organization.

URI

POST /v2/manage/namespaces

Request

  • Request parameters

    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:

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

    Body:

    {
        "namespace": "group"
    }

Response

  • Response parameters

    N/A

  • Example response

    {}

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.