OpenAI 获取用户的组织角色
2026-11-19 17:50 更新
获取用户的组织角色
get /organization/users/{user_id}/roles/{role_id}
获取分配给指定用户的组织角色。
路径参数
user_id: string
要查询的用户 ID。
role_id: string
要查询的组织角色 ID。
返回值
id: string
角色 ID。
assignment_sources: array of object { principal_id, principal_type } or null
如果可用,返回该角色分配所继承自的主体。
principal_id: string
principal_type: string
created_at: integer or null
角色创建时间。
format: unixtime
created_by: string or null
创建角色的操作者 ID。
created_by_user_obj: map[unknown] or null
如果可用,返回创建该角色的操作者的用户详情。
description: string or null
角色描述。
metadata: map[unknown] or null
角色上保存的自定义元数据。
name: string
角色名称。
permissions: array of string
角色关联的权限。
predefined_role: boolean
角色是否由 OpenAI 预定义。
resource_type: string
角色适用的资源类型。
updated_at: integer or null
角色的最近更新时间。
format: unixtime
示例
## 从环境变量读取管理员密钥。查询指定用户的组织角色
curl "https://api.openai.com/v1/organization/users/user_abc123/roles/role_01J1F8ROLE01" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
{
"id": "role_01J1F8ROLE01",
"name": "API Group Manager",
"permissions": [
"api.groups.read",
"api.groups.write"
],
"resource_type": "api.organization",
"predefined_role": false,
"description": "Allows managing organization groups",
"created_at": 1711471533,
"updated_at": 1711472599,
"created_by": "user_abc123",
"created_by_user_obj": null,
"metadata": {},
"assignment_sources": null
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: