跳转到主要内容
PATCH
/
v2
/
enterprise
/
organizations
/
{org_id}
/
members
/
migrate-roles
curl -X PATCH "https://api.devin.ai/v2/enterprise/organizations/org_123/members/migrate-roles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_role_id": "org_member",
    "target_role_id": "org_admin"
  }'

{
  "status": "success"
}
在特定组织内，将所有成员从源组织角色迁移到目标组织角色。这在组织内重构权限、需要批量更新角色时非常有用。此操作不会影响群组成员关系。

​
路径参数

​
org_id
string
required
组织的唯一标识符

​
请求体

​
source_role_id
string
required
要从中迁移用户的角色 ID。必须是组织级角色（role_type=“org”）。该组织中拥有此角色的所有用户都会被更新。
​
target_role_id
string
required
要将用户迁移到的角色 ID。必须是组织级角色（role_type=“org”）。使用 List available roles 端点获取有效的角色 ID。

​
响应

​
status
string
required
操作的状态。当迁移成功完成时返回 “success”。
curl -X PATCH "https://api.devin.ai/v2/enterprise/organizations/org_123/members/migrate-roles" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_role_id": "org_member",
    "target_role_id": "org_admin"
  }'

{
  "status": "success"
}

​
错误响应

​
400
error
错误请求 - 一个或两个指定的角色 ID 不是组织级角色
​
403
error
禁止访问 - 用户未关联到企业，或不具备管理组织成员资格的权限
​
404
error
未找到 - 在该企业中未找到该组织