请登录后查看
UpdateDepartment
修改部门
企业管理员通过该接口修改部门。
名称 | 类型 | IN | 必选 | 描述 |
---|---|---|---|---|
Accept-Language | string | header | 否 | 语言参数,默认为中文zh-CN,英文为en-US。 |
X-Request-Id | string | header | 否 | 请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
X-Access-Token | string | header | 是 | Access Token。通过 执行App ID鉴权接口返回的accessToken。 |
dept_code | string | path | 是 | 部门编码。 长度: 0-32位。 |
名称 | 类型 | 必选 | 描述 |
---|---|---|---|
deptName | string | 否 | 部门名称。 |
parentDeptCode | string | 否 | 父部门编码。 |
note | string | 否 | 备注。 |
inPermission | string | 否 | 其他用户对该部门下用户的访问权限:
|
outPermission | string | 否 | 该部门下用户访问权限控制。
|
designatedOutDeptCodes | Array of strings | 否 | 允许访问的部门列表,仅outPermission为DESIGNATED_DEPARTMENT时有效,最多支持配置150个部门。 |
sortLevel | integer | 否 | 部门排序号,序号越小,部门排序越靠前。 |
操作成功。
参数异常。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
权限受限。
名称 | 类型 | 描述 |
---|---|---|
error_code | string | 错误码。 |
error_msg | string | 错误描述。 |
request_id | string | 请求唯一标识。 |
"PUT https://{endpoint}/v1/usg/dcs/corp/dept/deptcode123456"
{
"deptName": "综合管理部-修改",
"parentDeptCode": "1",
"note": "负责公司XX, XX等业务",
"inPermission": "UNLIMITED",
"outPermission": "UNLIMITED",
"sortLevel": 10000
}
参数异常。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.201030001",
"error_msg": "同级部门名称已存在"
}
权限受限。
{
"request_id": "208b6e4c92074487bc43292f8554561e",
"error_code": "USG.000000004",
"error_msg": "Illegal request"
}