Put Records

Purpose   

To update existing entities in the module.

Endpoints

CopiedPUT /{module_api_name}

PUT /{module_api_name}/{record_id}

 

Request Details   


Request URL   

https://www.zohoapis.com/iot/{version}/{module_api_name}

To update a specific record:

https://www.zohoapis.com/iot/{version}/{module_api_name}/{record_id}

Note: "zohoapis.com" refers to the constant domain address used in Zoho IoT apis to fetch records from the registered application in the authorization process.

Replace your location's Base API URI (.in, .eu, .sa, or .au) instead of .com.
 

Supported Modules 

Devices, Assets, Locations, Alarms, Datapoints, Products, Manufacturers, Vendors, Certificates, Policies, Commands, Users, and Custom Modules (user-defined modules created based on specific business requirements).

 

 Headers 

Authorization: Zoho-oauthtoken {{oauth}}

 

Scope   

scope=ZohoIOT.modules.{module_name}.{operation_type}

 

Possible module api names   

devices, assets, locations, alarms, datapoints, products, manufacturers, vendors, certificates, policies, commands, users.
 

Possible operation types   

ALL - Full access to the record
UPDATE - Put records in the module
 

Request JSON Keys  

  • id - String, mandatory

Specify the unique ID of the record that you want to update. Refer to Get Records API to get the unique ID of the record.

  • $modified_values JSON object, optional

Represents the value that has to be modified for the particular record.

Sample Request: First API Call

Copiedurl --location -g --request PUT 'https://www.zohoapis.com/iot/v1/trips/2000000087157' \
--header 'Authorization: Zoho-oauthtoken {{oauth}}' \
--header 'Content-Type: application/json' \
--data '{

{"assets":{"name":"a1","connected_gateway":"469000000187815","edge_name":"","located_at":"469000000217089","serial_id":"","geolocation":null,"model_id":"469000000050182","undefined":"469000000167203","id":"469000000177001"}}
}'

Sample Input

Copied{"assets":{"record_image":"kzzrdc697e5ef5d44427d9260974404f29d13","name":"a1","description":"","connected_gateway":"469000000187815","edge_name":"","located_at":"469000000217089","serial_id":"","geolocation":null,"model_id":"469000000050182","undefined":"469000000167203","id":"469000000177001"}}

Sample Output

Copied{
    "assets": [
        {
            "code": "SUCCESS",
            "name": "a1",
            "id": "469000000177001",
            "message": "record updated",
            "status": "success"
        }
    ]
}