修改分组
接口概述#
- 功能：修改分组
- 请求方式：POST
- 请求地址：/api/contacts/teams/{team_id}/groups/{group_id}
请求参数#
| 参数名 | 类型 | 必须 | 参数位置 | 描述 | 示例值 |
|---|---|---|---|---|---|
| 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 |