Zoho crm Logo

转移用户并删除角色

目的

在你的组织中删除一个角色并将用户转移到新角色。

  • 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"
}