转移用户并删除角色
目的
在你的组织中删除一个角色并将用户转移到新角色。
- DELETE /settings/roles/{role_ID}
请求详情
请求 URL
{api-domain}/crm/{version}/settings/roles/{role_ID}
标题
授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
ZohoCRM.设置.角色.{operation_type}
可能的操作类型
ALL - 完全访问角色数据
DELETE - 删除角色数据
参数
- transfer_to_ID 字符串,必填
指定用户必须转移到的角色的唯一ID。
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/settings/roles/4150868000005435016?transfer_to_id=4150868000000026005"
-X DELETE
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"可能的错误
- INVALID_REQUEST_METHOD HTTP 400
HTTP请求方法类型无效
解决方法: 您指定了无效的HTTP方法来访问API URL。请指定有效的请求方法。更多详情请参阅本页开头的端点部分。 - INVALID_DATA HTTP 400
提供的ID似乎无效
解决方法: 请求URL中指定的角色ID无效。请指定有效的角色ID。 - REQUIRED_PARAM_MISSING HTTP 400
缺少预期的参数
解决方法:在请求输入中指定transfer_to_id参数。 - UNABLE_TO_PARSE_DATA_TYPE HTTP 400
请求体或参数的格式不正确
解决方法:transfer_to_id 中指定的值格式有误。请参考右侧的示例,并输入有效内容。 - OAUTH_SCOPE_MISMATCH HTTP 401
您用于此 API 调用的访问令牌不包含所需的权限范围(scope)。
解决方法: 生成一个包含此 API 所需权限范围的新访问令牌。有关所需权限范围的列表,请参阅本页开头的 权限范围 部分。 - AUTHORIZATION_FAILED HTTP 401
用户没有足够的权限删除角色
解决方法:用户没有删除权限。请联系系统管理员。 - NO_PERMISSION HTTP 403
没有删除权限
解决方法:用户没有删除角色数据的权限。请联系系统管理员。 - INVALID_URL_PATTERN HTTP 404
请求的 URL 不正确。
解决方法:请指定有效的请求 URL。更多详情请参见本页开头的请求 URL部分。 - INTERNAL_ERROR HTTP 500
服务器内部错误
解决方法:服务器中出现了意外且未处理的异常。请联系支持团队。
示例响应
Copied{
"code": "SUCCESS",
"details": {
"id": "4150868000005435016"
},
"message": "Role Deleted",
"status": "success"
}