Create an organization

Create a child organization under the specified organization.

Access control

Requires the caller to be an admin in the parent organization (i.e. the one on the path), or any of its ancestors. In addition, the flag adminsCanCreateOrgsInSubtree must be set to true in that organization.

Example: Assume an organization hierarchy like: org-a -> org-b -> org-c. To create a new organization under org-c, which means calling 'POST /api/v1/orgs/org-c/orgs', the caller must be an admin in at least one of org-a, org-b, or org-c, and adminsCanCreateOrgsInSubtree must be true in that same organization.

Securityorg-oidc-token
Request
path Parameters
org
required
string (OrgId) [ 3 .. 64 ] characters ^([a-z][a-z0-9-]{1,62}[a-z0-9])$

ID of an organization

Example: my-org
Request Body schema: application/json
required

A request to create an organization.

required
Array of objects (OrganizationRequestItem) = 1 items
Responses
201

A successfully created organization

403

Creation forbidden: The caller is not allowed to create sub-organizations.

post/api/v1/orgs/{org}/orgs
Request samples
application/json
{
  • "items": [
    • {
      }
    ]
}
Response samples
application/json
{
  • "items": [
    • {
      }
    ]
}
➔ Next to Delete an organization