调整成员角色

PATCH/v2/orgs/{org_id}/members/{user_id}

修改成员在组织内的角色。

不允许将组织中最后一名 owner 降级；该约束在数据库层面以行锁保证，并发请求只会有一个成功。

Bearer Token orgs:write api.demo.acme-cloud.dev

请求参数

共 2 项

org_id 必填路径

string

组织 ID

user_id 必填路径

string

用户 ID

请求体

application/json

role 必填

string

新角色

可选值owneradminmemberviewer

响应

3 种状态

200 OK

响应示例

{
  "org_id": "org_2c91",
  "user_id": "user_5b1e08",
  "role": "admin",
  "updated_at": "2026-10-16T07:33:12Z"
}

代码示例

cURL

curl -i -X PATCH 'https://api.demo.acme-cloud.dev/v2/orgs/org_2c91/members/user_5b1e08' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "admin"
}'