Updated on 2024-03-15 GMT+08:00

Deleting an OU

Function

This API is used to delete an OU from the root or another OU. Before deleting an OU, you must remove all member accounts from the OU or move them to another OU, and also remove the child OUs from the OU. This API can be called only from the organization's management account.

URI

DELETE /v1/organizations/organizational-units/{organizational_unit_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

organizational_unit_id

Yes

String

Unique ID of an OU.

Maximum: 35

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Security-Token

No

String

Security token (session token) of your temporary security credentials. If a temporary security credential is used, this header is required.

Minimum: 1

Response Parameters

None

Example Requests

Deleting an OU

DELETE https://{hostname}/v1/organizations/organizational-units/{organizational_unit_id}

Example Responses

None

Status Codes

Status Code

Description

204

Successful

Error Codes

See Error Codes.