Skip to content

用户组

按类型批量添加成员

POST /api_v3/admin/user_groups/{id}/members
  • 支持版本 >=26.1.4
  • 权限 admin_user_group_manage

参数

参数位置类型必选说明
idpathinteger用户组 ID(user_group.id)
typebodystring成员类型:user(用户)、org(部门)、post(岗位)
memberIdsbodyinteger[]成员主体 id 数组:type=user 为用户 id,type=org 为部门 id,type=post 为岗位 id。type=user 时仅处理非系统、非已删除用户。单次最多 1000 条

响应

json
{
  "status": true,
  "data": {
    "added": [
      {
        "type": "user",
        "memberId": "1"
      },
      {
        "type": "user",
        "memberId": "2"
      }
    ],
    "skipped": []
  }
}

字段说明

参数类型说明
statusboolean成功
dataobject结果
data.addedarray本次新加入的成员列表
data.added[].typestring成员类型:user / org / post
data.added[].memberIdstring成员主体 id
data.skippedarray请求的 memberIds 中已在组内、未重复添加的成员列表
data.skipped[].typestring成员类型:user / org / post
data.skipped[].memberIdstring成员主体 id