Disassociate Users from Territory

Purpose

To disassociate users from a territory in your organization.

Request Details

Request URL

{api-domain}/crm/{version}/settings/territories/{territoryid}/users/{userid}
or {api-domain}/crm/{version}/settings/territories/{territoryid}/users

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Scope

scope=ZohoCRM.settings.territories.All
(or)
scope=ZohoCRM.settings.territories.DELETE (and) ZohoCRM.users.All

Sample Request

Copiedcurl "https://www.zohoapis.com/crm/v7/settings/territories/431581000000744113/users?ids=431581000000258001"
-X DELETE
x-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"

Parameters

  • ids

    Represents the unique ID of the user you want to disassociate from the territory.This can be obtained from Get Users API

Note

A single user can be disassociated from the territory through the URL. You can disassociate single/multiple single users through the parameter ids

Sample Response

Copied{
    "users": [
        {
            "code": "SUCCESS",
            "details": {
                "id": "431581000000258001"
            },
            "message": "Given User Removed from the mentioned territory Successfully",
            "status": "success"
        }
    ]
}

Possible Errors

  • INTERNAL_ERRORHTTP 500

    Internal Server Error
    Resolution: Unexpected and unhandled exception in Server. Contact support team.

  • INVALID_DATAHTTP 400

    The ser is not a member of this territory.
    Resolution: Try to remove the users who is a part of the territory.

  • INVALID_REQUEST_METHODHTTP 400

    The http request method type is not a valid one
    Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to endpoints section above.