OpenAI 列出项目用户
2026-11-17 18:25 更新
列出项目用户
get /organization/projects/{project_id}/users
返回项目中的用户列表。
路径参数
project_id: string
项目 ID。
查询参数
after: optional string
分页游标。after 是标记列表位置的对象 ID。例如,列表请求返回100个对象,最后一个为 obj_foo;后续调用可传入 after=obj_foo,以获取下一页。
limit: optional integer (default: 20)
返回的对象数量上限。取值范围为1至100,默认值为20。
返回值
data: array of ProjectUser
id: string
标识符,可在 API 端点中引用。
added_at: integer
项目添加时间的 Unix 时间戳,单位为秒。
译注:此处按官方字段说明翻译;原文写的是项目添加时间,而不是明确说明用户加入项目的时间。
format: unixtime
object: "organization.project.user"
对象类型,固定为 organization.project.user。
"organization.project.user"
role: string
owner(所有者)或 member(成员)。
email: optional string or null
用户的电子邮件地址。
name: optional string or null
用户名称。
has_more: boolean
object: string
first_id: optional string or null
last_id: optional string or null
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/users" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY"
200 — 示例
{
"data": [
{
"id": "id",
"added_at": 0,
"object": "organization.project.user",
"role": "role",
"email": "email",
"name": "示例名称"
}
],
"has_more": true,
"object": "object",
"first_id": "first_id",
"last_id": "last_id"
}
示例
## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/proj_abc/users?after=user_abc&limit=20" \
-H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
-H "Content-Type: application/json"
响应示例
{
"object": "list",
"data": [
{
"object": "organization.project.user",
"id": "user_abc",
"name": "示例用户",
"email": "user@example.com",
"role": "owner",
"added_at": 1711471533
}
],
"first_id": "user-abc",
"last_id": "user-xyz",
"has_more": false
}以上内容是否对您有帮助:

TRAE-AI编程


更多建议: