Update Department
# Not recommended to continue using deprecated interfaces!!!
# Description
Update department information
# Request Specification
Method: POST + application/json
Endpoint: https://${cloud domain}/cgi/crm/v2/data/update?thirdTraceId=${Random String}
# Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| corpAccessToken | String | Yes | Enterprise app access token for validation |
| corpId | String | Yes | Open platform company account |
| department | Map | Yes | |
| id | Int | Yes | Department ID |
| name | String | Yes | Department name (must be unique), omit if no change |
| parentId | Int | Yes | Parent department ID (0 for top-level), omit if no change |
| order | Int | Yes | Department sort order, omit if no change |
| principalOpenUserId | String | Yes | Open platform user ID of department manager |
# Request Example
{
"corpAccessToken": "{corpAccessToken}",
"currentOpenUserId": "{currentOpenUserId}",
"corpId": "{corpId}",
"openUserId": "FSUID_xxxxxxxxxxxxxxxxxxxx",
"openUserIds": [
"FSUID_xxxxxxxxxxxxxxxxxxxx"
],
"status": 1
}
# Response Parameters
| Parameter | Type | Description |
|---|---|---|
| traceId | string | Unique request ID |
| errorDescription | string | Error description |
| errorMessage | string | Error message |
| errorCode | Int | Error codes |
# Response Example
{
"traceId": "E-O.827xxxxxx",
"errorDescription": "success",
"errorMessage": "OK",
"errorCode": 0
}
# Notes
- Do not use the message field in response for logical judgment as errorMessage may change;