将用户类型的用户转移
目的
在门户中将某一用户类型的用户转移到另一用户类型。
端点
- POST /settings/portals/{portal_name}/user_type/{user_type_id}/users/action/transfer
请求详情
请求 URL
{api-domain}/crm/{version}/settings/portals/{portal_name}/user_type/{user_type_id}/users/action/transfer
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.settings.clientportal.ALL
(或)
scope=ZohoCRM.settings.clientportal.UPDATE
参数
- transfer_To 必填
要将用户转移到的用户类型的ID。
- personality_ids 必填
要转移到新用户类型的用户的ID,使用逗号分隔。
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/portals/ZohoTest17/user_type/1947281000000470169/users/action/transfer?transfer_To=1306462000001857001&personality_ids=1306462000000659009"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X POST可能的错误
- INVALID_DATA HTTP 400
- 个性 ID 无效。该个性要么不属于任何门户用户,要么不属于此用户类型,或者用户类型无效。
解决方法:请指定正确的个性 ID。 - 您正在尝试将用户转移到自定义用户类型。
解决方法:您只能将用户转移到自定义用户类型。
- 个性 ID 无效。该个性要么不属于任何门户用户,要么不属于此用户类型,或者用户类型无效。
- REQUIRED_PARAM_MISSING HTTP 400
- 您未指定 transfer_To 或 personality_ids。
解决方法:transfer_To 或 personality_ids 是必填参数。
- 您未指定 transfer_To 或 personality_ids。
- LICENSE_LIMIT_EXCEEDED HTTP 403
您已超出组织门户的许可证限制。
解决方法:请联系管理员或support@zohocrm.com购买用户类型附加包。 - NO_PERMISSION HTTP 403
“客户门户用户”权限已被禁用。
解决方法:请联系您的管理员,并设置“客户门户用户”以转移用户。
示例响应
Copied{
"users": [
{
"code": "SUCCESS",
"details": {
"personality_id": "1306462000000659009"
},
"message": "User has been transferred successfully",
"status": "success"
}
]
}