编辑分组
更新时间:2025-07-02 08:03:16

编辑分组

请求方法

PUT

请求地址

/open/api/v1/users/groups/{groupId}

请求参数

参数 参数类型 数据类型 是否必须 描述
groupId Path String 分组Id,长度32
name Body String 分组名称,长度小于128
parentId Body String 父分组id,长度32
leaderIds Body String[] 分组负责人列表

HTTP状态码

返回值 描述
200 操作成功
400 客户端传参异常
401 鉴权失败
500 服务端异常

请求消息示例

PUT /open/api/v1/users/groups/b4eefd278c444e039dfe81147fab8cc9 HTTP/1.1
Host: smart.yealink.com
Content-Type: application/json

{
    "name": "openApi-1",
    "parentId": "9214e7bce3444e69a49e812f33da7731",
    "leaderIds": [
        "d8f6347163764cdbbb6e602188481a54"
    ]
}

响应消息示例

HTTP/1.1 200 
Content-Type: application/json;charset=UTF-8

CURL命令示例

curl -XPUT -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d '{"name":"openApiGroup2","parentId":"53f0765fadb54fb6b002f3baac2d5ec8"}' 'https://smart.yealink.com/open/api/v1/users/groups/b4eefd278c444e039dfe81147fab8cc9'
本页目录