Saves the system tools history retention configuration. Accepts a JSON body with 'maxHistoryCount' and optional 'saveAndApplyNow' flag to immediately purge records beyond the new limit.
put /dcapi/tools/systemTools/settings
https://{server-hostname}:8383/dcapi/tools/systemTools/settings
Tools.UPDATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request PUT \
--url https://appdomain/dcapi/tools/systemTools/settings \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/taskHistorySettings.v1+json' \
--data '{"maxHistoryCount":200,"saveAndApplyNow":true}' {
"maxHistoryCount": 200,
"saveAndApplyNow": true
}
Result of the operation: success or failure
{
"status": "success"
}
![]()
Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes
Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.