Updated on 2025-02-20 GMT+08:00

Registering an OU

Function

This API is used to register an OU in an organization with RGC.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

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

Registering an OU in an organization with RGC

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

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.