更新角色

PATCH

/ws-groups/{ws_group_id}

更新角色名/描述。group_name 或 group_desc 至少传一项；group_desc=null 会被转成空串（清空描述）。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Header 参数

Body 参数application/json必填

示例

rename清空描述

{
    "group_name": "技术部 v2"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

rename清空描述

curl --location --request PATCH 'https://app.emooai.com/open-api/v1/ws-groups/' \
--header 'Emoo-User-Id: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "group_name": "技术部 v2"
}'

返回响应

🟢200

application/json

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

4029 ws_group_name_exists（改名时新名字已被占用）

4031 ws_group_not_found（ws_group_id 不存在）

4084 invalid_open_api_user_id

Bodyapplication/json

示例

{
    "code": 200,
    "message": "success",
    "data": {
        "id": 0,
        "group_name": "string",
        "group_desc": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "avatar_url": "string"
    }
}

🟠400

🟠401

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

批量按 id 查询角色

删除角色