Initiates an immediate power operation on the specified computers. Accepts a JSON body specifying the operation type (shutdown, restart, logoff, lock, hibernate), target computers, shutdown message, timeout, postpone or skip options, and targeted users for selective logoff.
put /dcapi/tools/shutdown/executeShutdownNow
https://{serverurl}/dcapi/tools/shutdown/executeShutdownNow
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
curl --request PUT \
--url https://appdomains/dcapi/tools/shutdown/executeShutdownNow \
--header 'Accept: application/shutdownNowStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/shutdownNowParams.v1+json' \
--data '{}' {
"mode": "immediate",
"shutdownMessageTitle": "Shutdown Notice",
"postPoneEnabled": false,
"operationStr": "Shutdown",
"shutdownTimeout": 60,
"skipEnabled": false,
"shutdownMessage": "Immediate maintenance shutdown.",
"shutdownMode": 1,
"taskPlatformID": 1,
"operation": 1,
"computers": [
101,
202
]
}
Result of the trigger operation: success or failure
Number of devices for which the operation was successfully triggered
{
"triggeredCount": 2,
"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.