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.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

• If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
• If you are using identity policy-based authorization, the following identity policy-based permissions are required.

  Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
  organizations:ous:delete	Write	ou *	g:ResourceTag/<tag-key>	-	-

URI

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

Request Parameters

Response Parameters

Status code: 204

Successful

None

Example Requests

Deleting an OU

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

Example Responses

None

Status Codes

Error Codes

See Error Codes.