Creating an OU

Function

This API is used to create an OU in an organization via RGC. The OU will be automatically registered in RGC.

URI

POST https://{endpoint}/v1/managed-organization/managed-organizational-units

Request Parameters

**Table 1** Request body parameters
Parameter	Mandatory	Type	Description
name	Yes	String	Name of the new OU.
parent_id	Yes	String	Unique ID of the root OU or OU you want to create a new OU in.

Response Parameters

Status code: 201

**Table 2** Response body parameters
Parameter	Type	Description
manage_account_id	String	Management account ID.
organizational_unit_id	String	ID of a registered OU.
organizational_unit_name	String	Name of a registered OU.
organizational_unit_status	String	Status of a registered OU.
organizational_unit_type	String	Type of an OU. CORE - Foundational OU CUSTOM - OU ROOT - Root OU
parent_organizational_unit_id	String	ID of a registered parent OU.
parent_organizational_unit_name	String	Name of a registered parent OU.
created_at	String	Time when a registered OU was created.
landing_zone_version	String	Landing zone version of a registered OU.

Example Requests

Creating an OU in an organization via RGC (automatically registered)

POST https://{endpoint}/v1/managed-organization/managed-organizational-units

{
  "name" : "string",
  "parent_id" : "string"
}

Example Responses

Status code: 201

Successful

{
  "manage_account_id" : "string",
  "organizational_unit_id" : "string",
  "organizational_unit_name" : "string",
  "organizational_unit_status" : "string",
  "organizational_unit_type" : "CORE",
  "parent_organizational_unit_id" : "string",
  "parent_organizational_unit_name" : "string",
  "created_at" : "2023-11-21T06:51:45.364Z"
}