OpenAI 列出群组用户

列出群组用户

get /organization/groups/{group_id}/users

列出已分配到群组的用户。

路径参数

• group_id: string

要查看的群组 ID。

查询参数

• after: optional string

分页游标。传入上一列表响应中最后一个用户的 ID，以获取下一页。

• limit: optional integer (default: 100)

返回的用户数量上限。取值范围为0至1000，默认值为100。

minimum: 0, maximum: 1000

• order: optional "asc" or "desc" (default: "desc")

指定列表中用户的排序方式。

• "asc"

• "desc"

返回值

• data: array of OrganizationGroupUser

当前页中的用户。

• id: string

标识符，可在 API 端点中引用。

• email: string or null

用户的电子邮件地址。

• name: string

用户名称。

• has_more: boolean

分页时是否还有更多用户可获取。

• next: string or null

获取下一页结果的游标；没有更多用户时为 null。

• object: "list"

固定为 list。

• "list"

示例

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

200 — 示例

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

{
  "data": [
    {
      "id": "id",
      "email": "email",
      "name": "示例名称"
    }
  ],
  "has_more": true,
  "next": "next",
  "object": "list"
}

示例

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

响应示例

以下为对应请求的响应示例，名称和描述已中文化。

{
    "object": "list",
    "data": [
        {
            "id": "user_abc123",
            "name": "艾达·洛芙莱斯",
            "email": "ada@example.com"
        }
    ],
    "has_more": false,
    "next": null
}