Assign Organization Structures¶

Assign an organization structure to a user.

Prerequisites¶

The application has been granted the “Authorize users in this OU” permission. Contact the OU administrator to get the permission if necessary.

Request Format¶

POST https://{apigw-address}/app-portal-service/v2.2/structure/appendStructures

Request Parameters (Body)¶

Name	Required/Optional	Data Type	Description
organizationId	Required	String	The OU ID. How to get organizationld>>
userId	Required	String	The user ID. How to get userId >>
structureIds	Required	List	The ID of the organization structure to assign to the user.

Response Parameters¶

Name	Data Type	Description
data	Boolean	Whether the organization structure is successfully assigned. `true` indicates successful assignment, `false` indicates failed assignment.

Error Codes¶

Code	Description
31400	Errors such as incorrect parameters, empty parameters, character limits exceeded, and so on
31403	The application has not been granted the “Authorize users in this OU” permission
31404	Organization not found or user in this organization not found

Samples¶

Request Sample¶

url: https://{apigw-address}/app-portal-service/v2.2/structure/appendStructures

method: POST

requestBody:
{"organizationId":"yourOrgId", "userId":"yourUserId","structureIds": ["st1","st2","st3"]}

Return Sample¶

{
  "code": 0,
  "message": "OK",
  "data": true
}