OpenAI 修改项目用户

2026-11-17 18:25 更新

修改项目用户

post /organization/projects/{project_id}/users/{user_id}

修改用户在项目中的角色。

路径参数

  • project_id: string

项目 ID。

  • user_id: string

用户 ID。

请求体参数

内容类型:application/json

  • role: optional string or null

owner(所有者)或 member(成员)。

返回值

  • ProjectUser object { id, added_at, object, 3 more }

表示项目中的单个用户。

  • 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

用户名称。

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl "https://api.openai.com/v1/organization/projects/$PROJECT_ID/users/$USER_ID" \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
    -d '{}'

200 — 示例

{
  "id": "id",
  "added_at": 0,
  "object": "organization.project.user",
  "role": "role",
  "email": "email",
  "name": "示例名称"
}

示例

## 从环境变量读取管理员密钥;先把项目、资源 ID 和请求参数替换为实际值
curl -X POST "https://api.openai.com/v1/organization/projects/proj_abc/users/user_abc" \
  -H "Authorization: Bearer $OPENAI_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "role": "owner"
  }'

响应示例

{
    "object": "organization.project.user",
    "id": "user_abc",
    "name": "示例用户",
    "email": "user@example.com",
    "role": "owner",
    "added_at": 1711471533
}
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号