Description

Batch add user roles (incremental)

Request Specification

Method: POST + application/json

Endpoint: https://${Cloud Domain}/cgi/crm/v2/special/roleAdd?thirdTraceId=${Random String}

Headers: Refer to Common Parameters

Request Parameters

Parameter	Type	Required	Description
data	Map	Yes	Dataset
majorRole	String	No	Primary role code. Required when data.updateMajorRole is true; optional when false
roleCodes	List	Yes	List of role codes
userIds	List	Yes	List of users
updateMajorRole	Boolean	Yes	Whether to update primary role name

Request Example

{
  "data": {
    "userIds": [
      "FSUID_XXXXXXXXXXXXXXXXX"
    ],
    "roleCodes": [
      "22222"
    ],
    "updateMajorRole": true,
    "majorRole": "xxxx"
  }
}

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 the response for logical judgment, as errorMessage may change;