OpenAI 列出用户的组织角色分配
2026-11-19 17:50 更新
列出用户的组织角色分配
get /organization/users/{user_id}/roles
列出组织内分配给指定用户的组织角色。
路径参数
user_id: string
要查询的用户 ID。
查询参数
after: optional string
分页游标。传入上一页响应的 next 字段值可继续列出组织角色。
limit: optional integer
限制返回的组织角色分配数量。
minimum: 0, maximum: 1000
order: optional "asc" or "desc"
所返回组织角色的排序顺序。
"asc"
"desc"
返回值
data: array of object { id, assignment_sources, created_at, 9 more }
当前页返回的角色分配。
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
has_more: boolean
分页时是否还有更多分配。
next: string or null
获取下一页结果所用的游标。如果没有更多分配,值为 null。
object: "list"
固定为 list。
"list"
示例
## 从环境变量读取管理员密钥。列出指定用户的组织角色分配
curl "https://api.openai.com/v1/organization/users/user_abc123/roles" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
{
"object": "list",
"data": [
{
"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": {
"id": "user_abc123",
"name": "Ada Lovelace",
"email": "ada@example.com"
},
"metadata": {},
"assignment_sources": [
{
"principal_id": "user_abc123",
"principal_type": "user"
}
]
}
],
"has_more": false,
"next": null
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: