修改分组
接口概述
- 功能:修改分组
- 请求方式:POST
- 请求地址:/api/contacts/teams/{team_id}/groups/{group_id}?appid={appid}&access_token={access_token}
请求参数
参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
---|---|---|---|---|---|
team_id | integer | 是 | uri | 团队ID | 30 |
group_id | integer | 是 | uri | 分组ID | 30 |
name | string | 是 | body | 分组名称 | 测试分组 |
order | integer | 否 | body | 排序 | 1 |
from_id | integer | 否 | body | 原来所属的分组ID | 1 |
to_id | integer | 否 | body | 移动到新的分组下(移动分组时使用) | 1 |
响应参数
无
响应示例
- 请求成功
{
"code": "OK",
"error": {
"type": ""
},
"data": {},
"request_id": "e9ab73bf-6a50-406f-8b19-7af5eb9e916c"
}
- 请求失败
{
"code": "NotFound",
"error": {
"type": "contacts_group_not_found"
},
"data": {},
"request_id": "e82ce6af-3256-4805-aca6-b86c19d6c334"
}
错误码
error.type 错误代码 | 错误描述 |
---|---|
invalid_argument | 参数校验不通过 |
claim_error | 无权限 |
contacts_team_not_found | |
contacts_group_not_found | |
group_too_deep | |
parent_group_not_found | |
default_group_be_modified | |
duplicated_remote_id |