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
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: