OpenAI 列出项目群组
2026-11-17 18:23 更新
列出项目群组
get /organization/projects/{project_id}/groups
列出具有项目访问权限的群组。
路径参数
project_id: string
要查看的项目 ID。
查询参数
after: optional string
分页游标。提供上次响应中最后一个群组的 ID,以获取下一页。
limit: optional integer (default: 20)
返回的项目群组数量上限,默认为20。
minimum: 0, maximum: 100
order: optional "asc" or "desc" (default: "asc")
返回群组的排序顺序。
"asc"
"desc"
返回值
data: array of ProjectGroup
当前页返回的项目群组成员身份。
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
项目标识符。
has_more: boolean
是否还有其他项目群组成员身份可用。
next: string or null
用于获取下一页结果的游标;没有更多结果时为 null。
object: "list"
固定为 list。
"list"
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/groups" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"
200 — 示例
{
"data": [
{
"created_at": 0,
"group_id": "group_id",
"group_name": "示例群组",
"group_type": "group",
"object": "project.group",
"project_id": "project_id"
}
],
"has_more": true,
"next": "next",
"object": "list"
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/proj_abc123/groups?limit=20" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
{
"object": "list",
"data": [
{
"object": "project.group",
"project_id": "proj_abc123",
"group_id": "group_01J1F8ABCDXYZ",
"group_name": "支持团队",
"group_type": "group",
"created_at": 1711471533
}
],
"has_more": false,
"next": null
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: