Executes a scheduled power operation task immediately, bypassing its schedule Triggers an immediate execution of the specified scheduled power operation task, regardless of its configured schedule. The task is identified by its task ID in the URL path.
Request URL https://{server-hostname}:8383/dcapi/tools/shutdown/tasks/{taskId}/executeNow
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}/executeNow \
--header 'Accept: application/executeShutdownTaskInfo.v1+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}/executeNow"))
.header("Accept", "application/executeShutdownTaskInfo.v1+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/executeShutdownTaskInfo.v1+json",
'Authorization': " d92d4xxxxxxxxxxxxx15f52"
}
conn.request("PUT", "/dcapi/tools/shutdown/tasks/{taskId}/executeNow", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
headersMap = Map();
headersMap.put("Accept", "application/executeShutdownTaskInfo.v1+json");
response = invokeUrl
[
url: "https://appDomain/dcapi/tools/shutdown/tasks/{taskId}/executeNow"
type: PUT
headers: headersMap
connection: connection_name
]
info response;
$headers=@{}
$headers.Add("Accept", "application/executeShutdownTaskInfo.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/tools/shutdown/tasks/{taskId}/executeNow' -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.