Edit a Trip

Purpose

To update a trip record.

Request URL

https://fsm.zoho.com/fsm/v1/Trips/<record_id>

record_id - The unique ID of the record. You can obtain this ID from the List Trips API.

Request Method

PUT

Scope

scope=ZohoFSM.modules.Trips.UPDATE

Input JSON Parameters

NameDescriptionType

id

(mandatory)

The ID of the trip you want to update. You can obtain this ID from the List Trips API.String
AppointmentThe service appointment for which you want to create the trip. You can obtain this ID from the List Service Appointments API.String
Service_ResourceThe ID of the user for whom you want to create a time off. Use the id in the Service_Resources key present in the List Users API response.String
Start_Date_TimeProvide the start date and time for the trip in the ISO format YYYY-MM-DDThh:mm:ssTZD.

String

or

DateTime

End_Date_Time
 
Provide the end date and time for the trip in the ISO format YYYY-MM-DDThh:mm:ssTZD.

String

or

DateTime

Distance_Travelled

Details of the distance travelled

  • value: the magnitude of the distance traveled.
  • unit: the unit of measure for the travel distance

JSON Object

String

String

DescriptionAny additional information you want to add.String

Sample Request

Copiedcurl --request PUT 'https://fsm.zoho.com/fsm/v1/Trips' \
--header 'Authorization: Zoho-oauthtoken 1000.3xxxxxxxxx.xxxxxxxxxxxxx0e'
--header 'content-type: application/json' \
--data "{"field1":"value1","field2":"value2"}"

Sample Input

Copied{
    "data": [
        {
            "id": "1439000002533017",
            "End_Time": "2026-04-23T17:00:15+05:30"
        }
    ]
}

Sample Response

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "Modified_Time": "2026-04-21T17:46:44+05:30",
                "Modified_By": {
                    "name": "Alice Cooper",
                    "id": "1439000000161001"
                },
                "Created_Time": "2026-04-21T17:38:28+05:30",
                "id": "1439000002533017",
                "Created_By": {
                    "name": "Alice Cooper",
                    "id": "1439000000161001"
                }
            },
            "message": "record updated",
            "status": "success"
        }
    ]
}