All Products
Search
Document Center

Identity as a Service:ListOrganizationalUnitParentIds

Last Updated:Jul 31, 2025

Queries the information of all the parent organizational units of an organizational unit.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /v2/{instanceId}/{applicationId}/organizationalUnits/{organizationalUnitId}/parentIds HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
AuthorizationstringYes

The authentication information. Format: Bearer ${access_token}. Example: Bearer ATxxxx.

Bearer AT8csE2seYxxxxxij
instanceIdstringYes

The instance ID.

idaas_ue2jvisn35ea5lmthk267xxxxx
applicationIdstringYes

The application ID.

app_mkv7rgt4d7i4u7zqtzev2mxxxx
organizationalUnitIdstringYes

The ID of the organizational unit.

ou_wovwffm62xifdziem7an7xxxxx

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

parentIdsarray

The IDs of the parent organizational units. The IDs of the organizational unit are ordered based on their levels from high to low. Only the IDs of the organizational units within the authorization scope are displayed.

parentIdstring

The ID of the organizational unit.

ou_wovwffm62xifdziem7an7xxxxx

Examples

Sample success responses

JSONformat

{
  "parentIds": [
    "ou_wovwffm62xifdziem7an7xxxxx"
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-10-24The internal configuration of the API is changed, but the call is not affectedView Change Details