OpenAI 添加群组用户

添加群组用户

post /organization/groups/{group_id}/users

将用户添加到群组。

路径参数

• group_id: string

要更新的群组 ID。

请求体参数

内容类型：application/json

• user_id: string

要添加到群组的用户标识符。

返回值

• group_id: string

用户被添加到的群组的标识符。

• object: "group.user"

固定为 group.user。

• "group.user"

• user_id: string

已添加用户的标识符。

示例

## 从环境变量读取管理员密钥；群组、角色和用户ID应替换为实际值
curl https://api.openai.com/v1/organization/groups/$GROUP_ID/users \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "user_id": "user_id"
        }'

200 — 示例

以下 JSON 展示返回字段；字段名、对象类型、权限字符串和标识符按原文保留。

{
  "group_id": "group_id",
  "object": "group.user",
  "user_id": "user_id"
}

示例

## 从环境变量读取管理员密钥；群组、角色和用户ID应替换为实际值
curl -X POST https://api.openai.com/v1/organization/groups/group_01J1F8ABCDXYZ/users \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "user_id": "user_abc123"
  }'

响应示例

以下为对应请求的响应示例。

{
    "object": "group.user",
    "user_id": "user_abc123",
    "group_id": "group_01J1F8ABCDXYZ"
}