English
Get Users by Primary Role
About 142 wordsLess than 1 minute
2026-01-19
Description
Retrieve corresponding users by their primary role.
Request Specification
Method: POST + application/json
Endpoint: https://${Cloud Domain}/cgi/crm/v2/bi/lwt/query?thirdTraceId=${Random String}Headers: Refer to Common Parameters
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| includeNull | Boolean | No | Whether to include null fields. false: not returned, true: returned. Default is false |
| data | Map | Yes | Dataset |
| AuthContext | Map | No | Application context |
| roleCodes | List | Yes | Primary role codes |
Request Example
{
"includeNull": true,
"data": {
"AuthContext": {},
"roleCodes": [
"00000000000000000000000000000006"
]
}
}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
messagefield in the response for logical judgments, aserrorMessagemay change.
