OpenAI 获取项目群组

2026-11-17 18:23 更新

获取项目群组

get /organization/projects/{project_id}/groups/{group_id}

获取项目中的群组。

路径参数

  • project_id: string

要查看的项目 ID。

  • group_id: string

要获取的群组 ID。

查询参数

  • group_type: optional "group" or "tenant_group" (default: "group")

要获取的群组类型。

  • "group"

  • "tenant_group"

返回值

  • ProjectGroup object { created_at, group_id, group_name, 3 more }

群组在项目中的成员身份详情。

  • created_at: integer

群组获授项目访问权限时的 Unix 时间戳,单位为秒。

format: unixtime

  • group_id: string

具有项目访问权限的群组标识符。

  • group_name: string

群组的显示名称。

  • group_type: "group" or "tenant_group"

群组类型。

  • "group"

  • "tenant_group"

  • object: "project.group"

固定为 project.group。

  • "project.group"

  • project_id: string

项目标识符。

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/groups/$GROUP_ID" \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY"

200 — 示例

{
  "created_at": 0,
  "group_id": "group_id",
  "group_name": "示例群组",
  "group_type": "group",
  "object": "project.group",
  "project_id": "project_id"
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/proj_abc123/groups/group_01J1F8ABCDXYZ" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json"

响应示例

{
    "object": "project.group",
    "project_id": "proj_abc123",
    "group_id": "group_01J1F8ABCDXYZ",
    "group_name": "支持团队",
    "group_type": "group",
    "created_at": 1711471533
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号