Update Territory Assigned to Record

Purpose

To change the territory chosen for a Request, Estimate, Work Order, or Service Appointment record.

Request URL

https://fsm.zoho.com/fsm/v1/<module_api_name>/<record_id>/changeTerritory

record_id - The unique ID of the record.

Request Method

PUT

Scope

scope=ZohoFSM.modules.<module_name>.UPDATE

Query Parameters

Parameter Name	Data Type	Description
getRelation	Boolean	Use this parameter to fetch a list of related records that would also have their territory updated. This is intended only for preview purposes, allowing you to review the impacted records before performing the update. Note: Do not include this parameter when performing the actual update operation.

Input JSON Parameters

Name	Description	Type	Mandatory
id	The ID of the territory that the record should be updated to.	String	Yes

Supported Modules and Related Records

Module Name	API Name
Requests	Requests
Estimates	Estimates
WorkOrders	Work_Orders
ServiceAppointments	Service_Appointments

Sample Request

Copiedcurl --request PUT 'https://fsm.zoho.com/fsm/v1/Work_Orders/1003XXXX9018/changeTerritory' \
--header 'Authorization: Zoho-oauthtoken 1000.26xxxxxxxxxx.xxxxxxxxxx0' \
--header 'content-type: application/json' \
--data "{"field1":"value1"}"

Sample Input

Copied{
    "id":"1003000002058131"
}

Sample Response (Territory Update)

Copied{
    "code": "SUCCESS",
    "details": {
        "WorkOrders": [
            {
                "code": "SUCCESS",
                "details": {
                    "Modified_Time": "2025-10-28T17:44:04+05:30",
                    "Modified_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    },
                    "Created_Time": "2025-06-13T12:12:40+05:30",
                    "id": "1003000002742075",
                    "Created_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    }
                },
                "message": "record updated",
                "status": "success"
            }
        ],
        "ServiceAppointments": [
            {
                "code": "SUCCESS",
                "details": {
                    "Modified_Time": "2025-10-28T17:44:05+05:30",
                    "Modified_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    },
                    "Created_Time": "2025-06-13T12:13:37+05:30",
                    "id": "1003000002742124",
                    "Created_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    }
                },
                "message": "record updated",
                "status": "success"
            }
        ],
        "Estimates": [
            {
                "code": "SUCCESS",
                "details": {
                    "Modified_Time": "2025-10-28T17:44:05+05:30",
                    "Modified_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    },
                    "Created_Time": "2025-06-13T12:11:54+05:30",
                    "id": "1003000002742036",
                    "Created_By": {
                        "name": "Marianne Sheehan",
                        "id": "1003000000208001"
                    }
                },
                "message": "record updated",
                "status": "success"
            }
        ]
    },
    "message": "Change Territory Successful",
    "status": "success"
}

Sample Response (Related Records)

Copied{
    "code": "SUCCESS",
    "details": {
        "related_records": [
            {
                "module_label": "Work Orders",
                "records": [
                    {
                        "id": "1003000002742075",
                        "Name": "WO07"
                    }
                ],
                "api_name": "Work_Orders"
            },
            {
                "module_label": "Estimates",
                "records": [
                    {
                        "id": "1003000002742036",
                        "Name": "ES13"
                    }
                ],
                "api_name": "Estimates"
            }
        ]
    },
    "status": "success"
}