OpenAI 向群组分配项目角色
2026-11-17 18:23 更新
向群组分配项目角色
post /projects/{project_id}/groups/{group_id}/roles
在项目中向群组分配项目角色。
路径参数
project_id: string
要更新的项目 ID。
group_id: string
要接收项目角色的群组 ID。
请求体参数
内容类型:application/json
role_id: string
要分配的角色标识符。
返回值
group: object { id, created_at, name, 2 more }
角色分配响应中返回的群组概要信息。
id: string
群组标识符。
created_at: integer
群组创建时间的 Unix 时间戳,单位为秒。
format: unixtime
name: string
群组的显示名称。
object: "group"
固定为 group。
"group"
scim_managed: boolean
群组是否通过 SCIM 管理。
object: "group.role"
固定为 group.role。
"group.role"
role: Role
可通过公共 Roles API 分配的角色详情。
id: string
角色标识符。
description: string or null
可选的角色描述。
name: string
角色的唯一名称。
object: "role"
固定为 role。
"role"
permissions: array of string
角色授予的权限。
predefined_role: boolean
角色是否由 OpenAI 预定义和管理。
resource_type: string
角色绑定的资源类型,例如 api.organization 或 api.project。
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/projects/$PROJECT_ID/groups/$GROUP_ID/roles" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-d '{
"role_id": "role_id"
}'
200 — 示例
{
"group": {
"id": "id",
"created_at": 0,
"name": "示例名称",
"object": "group",
"scim_managed": true
},
"object": "group.role",
"role": {
"id": "id",
"description": "示例描述",
"name": "示例名称",
"object": "role",
"permissions": [
"string"
],
"predefined_role": true,
"resource_type": "resource_type"
}
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/projects/proj_abc123/groups/group_01J1F8ABCDXYZ/roles" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json" \
-d '{
"role_id": "role_01J1F8PROJ"
}'
响应示例
{
"object": "group.role",
"group": {
"object": "group",
"id": "group_01J1F8ABCDXYZ",
"name": "支持团队",
"created_at": 1711471533,
"scim_managed": false
},
"role": {
"object": "role",
"id": "role_01J1F8PROJ",
"name": "项目 API 密钥管理员",
"description": "允许管理项目的 API 密钥",
"permissions": [
"api.organization.projects.api_keys.read",
"api.organization.projects.api_keys.write"
],
"resource_type": "api.project",
"predefined_role": false
}
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: