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
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号