批量更新用户信息

PUT

/ws-user

请求体为数组，每个元素更新一个用户。

需要 WS_USER EDIT 权限。

open_id 必填，ws_username / ext_info 可选。

响应 data 是失败条目数组（含 failed_type），成功时为 []；不会整体回滚，调用方需检查数组是否为空判断全成功。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

[
    {
        "open_id": "ou_xxx",
        "ws_username": "张三",
        "ext_info": {
            "department": "技术部"
        }
    },
    {
        "open_id": "ou_unknown",
        "ws_username": "不存在的人"
    }
]

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.emooai.com/open-api/v1/ws-user' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[
    {
        "open_id": "ou_xxx",
        "ws_username": "张三",
        "ext_info": {
            "department": "技术部"
        }
    },
    {
        "open_id": "ou_unknown",
        "ws_username": "不存在的人"
    }
]'

返回响应

🟢200

application/json

成功（code=200）。可能错误码：

4006 workspace_not_found

4084 invalid_open_api_user_id

注意：单条用户不存在不会返 4xxx，而是进入响应 data 失败数组（failed_type=open_id_not_found）。

Bodyapplication/json

示例

全部成功（data=[]）部分失败（data 含失败条目）

{
    "code": 200,
    "message": "success",
    "data": []
}

🟠400

🟠401

修改于 2026-08-23 11:45:57

获取工作区用户列表

批量按 open_id 查询用户