OpenAI 获取群组用户

获取群组用户

get /organization/groups/{group_id}/users/{user_id}

获取群组中的一个用户。

路径参数

• group_id: string

要查看的群组 ID。

• user_id: string

要从群组中获取的用户 ID。

返回值

• id: string

用户标识符。

• email: string or null

用户的电子邮件地址；没有电子邮件地址的用户为 null。

• is_service_account: boolean or null

用户是否为服务账号。

• name: string

用户显示名称。

• picture: string or null

用户头像的 URL（如果提供）。

• user_type: "user" or "tenant_user"

用户类型。

• "user"

• "tenant_user"

示例

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

200 — 示例

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

{
  "id": "id",
  "email": "email",
  "is_service_account": true,
  "name": "示例名称",
  "picture": "picture",
  "user_type": "user"
}

示例

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

响应示例

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

{
    "id": "user_abc123",
    "name": "艾达·洛芙莱斯",
    "email": "ada@example.com",
    "picture": null,
    "is_service_account": false,
    "user_type": "user"
}