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
{api-domain}/iot/{version}/{module_api_name}
To update a specific record:
{api-domain}/iot/{version}/{module_api_name}/{record_id}
Supported Modules
Devices, Assets, Locations, Alarms, Datapoints, Products, Manufacturers, Vendors, Certificates, Policies, Commands, Users.
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 '{{api-domain}}/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"
}
]
}