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.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
rgc:managedOrganizationalUnit:create	Write	-	-	-	-

URI

POST /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"
}