OpenAI 添加项目群组

2026-11-17 18:23 更新

添加项目群组

post /organization/projects/{project_id}/groups

授予群组访问项目的权限。

路径参数

  • project_id: string

要更新的项目 ID。

请求体参数

内容类型:application/json

  • group_id: string

要添加到项目的群组标识符。

  • role: string

要授予群组的项目角色标识符。

返回值

  • 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" \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{
          "group_id": "group_id",
          "role": "role"
        }'

200 — 示例

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

示例

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

响应示例

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

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号