Suspends a scheduled power operation task from future execution Suspends the specified scheduled power operation task, preventing it from executing on its next scheduled time. The task remains in the system and can be resumed later.
Request URL https://{server-hostname}:8383/dcapi/tools/shutdown/tasks/{taskId}/suspend
Scope
Header Authorization: d92d4xxxxxxxxxxxxx15f52
Request Parameters - Request Headers - Path Parameters taskId string Mandatory
The unique identifier of the task
Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request PUT \
--url https://appdomain/dcapi/tools/shutdown/tasks/{taskId}/suspend \
--header 'Accept: application/json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;
public class Main {
public static void main(String[] args) {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://appdomain/dcapi/tools/shutdown/tasks/{taskId}/suspend"))
.header("Accept", "application/json")
.header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
.method("PUT", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
import http.client
conn = http.client.HTTPSConnection("appdomain")
headers = {
'Accept': "application/json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("PUT", "/dcapi/tools/shutdown/tasks/{taskId}/suspend", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Accept", "application/json");
response = invokeUrl
[
url: "https://appDomain/dcapi/tools/shutdown/tasks/{taskId}/suspend"
type: PUT
headers: headersMap
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Accept", "application/json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/tools/shutdown/tasks/{taskId}/suspend' -Method PUT -Headers $headersResponse Parameters - HTTP code 200 Response Body - application/json Possible Response Codes Sample Response: HTTP 200 {
"status": "success"
}
▼ Show full
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.