Updated on 2025-07-11 GMT+08:00

Deregistering an OU

Function

This API is used to deregister an OU in an organization from RGC.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

managed_organizational_unit_id

Yes

String

ID of a registered OU.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

organizational_unit_operation_id

String

Operation ID of the asynchronous APIs.

Status code: 403

Table 3 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

request_id

String

Unique ID of the request.

encoded_authorization_message

String

Encrypted error message.

details

Array of ForbiddenErrorDetail objects

Error message indicating no permissions for cross-service invoking.

Table 4 ForbiddenErrorDetail

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

Deregistering an OU in an organization from RGC

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

{
  "OrganizationalUnitOperationId" : "string"
}

Example Responses

Status code: 200

Request succeeded.

{
  "organizational_unit_operation_id" : "string"
}

Status Codes

Status Code

Description

200

Request succeeded.

403

No permissions.

Error Codes

See Error Codes.