Description

Update Member.

Request Specification

Method: POST + application/json

Endpoint: https://${Cloud Domain}/cgi/user/update?thirdTraceId=${Random String}

Headers: Refer to Common Parameters

Request Parameters

Parameter	Type	Required	Description
user	Map	Yes	Department ID
openUserId	String	Yes	Employee ID
account	String	No	Employee account (must be unique); if not provided, it is not modified
name	String	No	Employee nickname (must be unique); if not provided, it is not modified
fullName	String	No	Employee name; if not provided, it is not modified
position	String	No	Position; if not provided, it is not modified
gender	String	No	Gender, valid values are {M, F}; if not provided, it is not modified
mobile	String	No	Mobile number (must be unique); if not provided, it is not modified
email	String	No	Email address; if not provided, it is not modified
qq	String	No	QQ number; if not provided, it is not modified
weixin	String	No	WeChat ID; if not provided, it is not modified
mainDepartmentId	Int	No	Primary department ID
attachingDepartmentIds	List	No	List of attached departments (a set of non-negative integers, maximum 500); if not provided, it is not modified
employeeNumber	String	No	Employee number; required when the enterprise allows duplicate system names
hireDate	String	No	Hire date
birthDate	String	No	Employee birthday
startWorkDate	String	No	Date of starting work
leaderId	String	No	Reporting manager

Request Example

{
  "user": {
    "openUserId": "fsuid_openId2",
    "account": "",
    "name": "xx-name",
    "fullName": "xxx-fullName",
    "position": "Manager",
    "gender": "M",
    "mobile": "15845698456",
    "email": "xxx@fxiaoke.com",
    "qq": "45682156",
    "weixin": "15010478956",
    "mainDepartmentId": "",
    "attachingDepartmentIds": [
      1.0,
      2.0,
      3.0
    ],
    "employeeNumber": "168XXXX123",
    "hireDate": "1504173600000",
    "birthDate": "1504627199000",
    "startWorkDate": "1504173600000",
    "leaderId": "FSUID_XXXXXXXXXXXXXXXXXXX"
  }
}

Response Parameters

Parameter	Type	Description
dataId	String	Data ID
traceId	string	Unique request ID
errorDescription	string	Error description
errorMessage	string	Error message
errorCode	Int	Error Codes

Response Example

{
  "dataId": "68faxxxxxx",
  "traceId": "E-O.827xxxxxx",
  "errorDescription": "success",
  "errorMessage": "OK",
  "errorCode": 0
}

Notes

• Do not use the message field in the response for logical judgments, as errorMessage may change.