Returns the immediate shutdown or restart settings including the timeout duration, message title, shutdown message, and operation mode. Accepts an 'operationType' query parameter (2 or 3) to specify the type of operation (shutdown or restart).
get /dcapi/tools/shutdown/settings
https://{serverurl}/dcapi/tools/shutdown/settings
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Type of power operation to retrieve settings for. Accepted values: 2 (shutdown), 3 (restart)
curl --request GET \
--url 'https://appdomains/dcapi/tools/shutdown/settings?operationType=SOME_INTEGER_VALUE' \
--header 'Accept: application/json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Operation type: 1=Shutdown, 2=Restart, 3=Logoff, 4=Lock, 5=Hibernate
Message displayed to end users before the operation executes
Title of the end-user notification dialog
Delay in seconds before the operation executes after the notification is shown
Execution mode: 1=Forced, 2=Graceful
{
"shutdownMessageTitle": "System Shutdown",
"shutdownTimeout": 300,
"operationType": 2,
"shutdownMessage": "System will shutdown for maintenance.",
"shutdownMode": 1
}
![]()
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.