Returns the configuration and status details of the specified scheduled power operation task, including task name, operation type, target computers, schedule, and current execution status.
get /dcapi/tools/shutdown/tasks/{taskId}
https://{serverurl}/dcapi/tools/shutdown/tasks/{taskId}
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique identifier of the task
curl --request GET \
--url https://appdomains/dcapi/tools/shutdown/tasks/{taskId} \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Scheduled shutdown task unique identifier
User-defined task name
Operation type: 1=Shutdown, 2=Restart, 3=Logoff, 4=Lock, 5=Hibernate
Human-readable operation name
Task status: Active, Suspended, Completed
Target platform: 1=Windows, 2=macOS
Message displayed to end users before the operation
Timeout in seconds before the operation executes
Whether end users can postpone the operation
Whether end users can skip the operation
Next scheduled execution time (epoch)
Number of target computers
{
"postPoneEnabled": true,
"operationStr": "Shutdown",
"nextRunTime": 1711508400000,
"shutdownTimeout": 300,
"skipEnabled": false,
"taskName": "Nightly Shutdown",
"shutdownMessage": "System will shutdown in 5 minutes.",
"operation": 1,
"targetCount": 20,
"taskId": 5,
"platform": 1,
"status": "Active"
}
![]()
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.