更新用户

PATCH/v2/users/{user_id}

局部更新用户资料、状态或角色。

PATCH 采用 JSON Merge Patch 语义：仅提交需要变更的字段，null 表示清空该字段。角色变更需要 roles:write 权限，且不允许移除组织中最后一名 owner。

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

请求参数

共 1 项

user_id 必填路径

string

user_id 唯一标识

请求体

application/json

display_name 可选

string

显示名称

status 可选

string

账号状态

可选值activesuspended

roles 可选

array<string>

覆盖式更新角色列表

可选值owneradminmemberviewer

profile 可选

object

扩展档案（合并写入）

响应

4 种状态

200 OK

响应示例

{
  "id": "user_7f3a21",
  "display_name": "Ada L.",
  "roles": [
    "admin",
    "member"
  ],
  "updated_at": "2026-10-16T07:20:03Z"
}

代码示例

cURL

curl -i -X PATCH 'https://api.demo.acme-cloud.dev/v2/users/user_id_7f3a21' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "display_name": "Ada L.",
  "roles": [
    "admin",
    "member"
  ]
}'