OpenAI 列出项目群组

2026-11-17 18:23 更新

列出项目群组

get /organization/projects/{project_id}/groups

列出具有项目访问权限的群组。

路径参数

  • project_id: string

要查看的项目 ID。

查询参数

  • after: optional string

分页游标。提供上次响应中最后一个群组的 ID,以获取下一页。

  • limit: optional integer (default: 20)

返回的项目群组数量上限,默认为20。

minimum: 0, maximum: 100

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

返回群组的排序顺序。

  • "asc"

  • "desc"

返回值

  • data: array of ProjectGroup

当前页返回的项目群组成员身份。

  • 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

项目标识符。

  • has_more: boolean

是否还有其他项目群组成员身份可用。

  • next: string or null

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

  • object: "list"

固定为 list。

  • "list"

示例

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

200 — 示例

{
  "data": [
    {
      "created_at": 0,
      "group_id": "group_id",
      "group_name": "示例群组",
      "group_type": "group",
      "object": "project.group",
      "project_id": "project_id"
    }
  ],
  "has_more": true,
  "next": "next",
  "object": "list"
}

示例

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

响应示例

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

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号