Creates a new scheduled task for remote power operations such as shutdown, restart, or log off

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Creates a new scheduled power operation task (shutdown, restart, log off, hibernate, or lock) targeting the specified computers or groups. Accepts a full task configuration JSON body including task name, operation type, platform, shutdown message, postpone or skip options, and schedule settings.

Endpoints

Request URL

https://{serverurl}/dcapi/tools/shutdown/tasks

Scope

DesktopCentralCloud.Tools.UPDATECopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/saveShutdownTask.v1+jsonapplication/saveShutdownTask.v1+jsonCopied!
Content-TypestringMandatory
application/shutdownTaskParams.v1+jsonapplication/shutdownTaskParams.v1+jsonCopied!

- Request Body

application/json
JSON Object
Hide Sub-Attributes
taskDetailsJSON ObjectOptional
Show Sub-Attributes
completionTimestringOptional
creationTimestringOptional
modestringOptional
ownerstringOptional
operationstringOptional
operationStrstringOptional
postPoneEnabledbooleanOptional
isDeleteOldTaskbooleanOptional
isCloneTaskbooleanOptional
reflectCustomGroupChangesbooleanOptional
shutdownMessagestringOptional
shutdownMessageTitlestringOptional
shutdownModestringOptional
shutdownTimeoutstringOptional
skipEnabledbooleanOptional
startTimestringOptional
statusstringOptional
taskNamestringOptional
taskIDstringOptional
taskPlatformIDstringOptional
notifyOldTargetMessagebooleanOptional
oldTaskMessagestringOptional
winAvailablebooleanOptional
bothAvailablebooleanOptional
macAvailablebooleanOptional
skipOrPostPonestringOptional
postPoneCountstringOptional
isUpTimeEnabledbooleanOptional
upTimeCountintegerOptional
scheduleJsonObjJSON ObjectOptional
Show Sub-Attributes
schedulerDisabledbooleanOptional
isOnceScheduleReqbooleanOptional
removeScheduleReqbooleanOptional
scheduleTypestringOptional
nextRunTimestringOptional
onceTimestringOptional
dailyTimestringOptional
dailyIntervalTypestringOptional
weeklyTimestringOptional
daysOfWeekstringOptional
monthlyTimestringOptional
monthsListstringOptional
monthlyPerformstringOptional
monthlyWeekDaystringOptional
monthlyWeekNumstringOptional
monthlyDaystringOptional
taskTimeZonestringOptional
targetDataJSON ObjectOptional
Show Sub-Attributes
allTargetsJSON ArrayOptional
Show Sub-Attributes
JSON Object
Show Sub-Attributes
singleTargetComponentJSON ArrayOptional
Show Sub-Attributes
JSON Object
Show Sub-Attributes
singleTargetRowJSON ObjectOptional
Show Sub-Attributes
rowPropertiesJSON ObjectOptional
Show Sub-Attributes
isMainTargetbooleanOptional
targetTypeintegerOptional
isExcludebooleanOptional
rowValuesJSON ArrayOptional
Show Sub-Attributes
JSON Object
Show Sub-Attributes
targetDisplayTextstringOptional
enteredValuestringOptional
orderintegerOptional
idValuestringOptional
isTargetValidbooleanOptional
isTargetRemovedstringOptional
cgTypeintegerOptional
excludeChildstringOptional
canonicalPathstringOptional
domainstringOptional
isTargetComputablebooleanOptional
mainTargetJSON ObjectOptional
Show Sub-Attributes
targetNamestringOptional
targetTypestringOptional
selectedValuesJSON ArrayOptional
Show Sub-Attributes
JSON Object
Show Sub-Attributes
labelstringOptional
idValuestringOptional
excludeChildstringOptional
canonicalPathstringOptional
domainstringOptional
isTargetComputablebooleanOptional
cgTypeintegerOptional
isTargetRemovedstringOptional
userRefineTargetJSON ObjectOptional
Show Sub-Attributes
includeTargetsJSON ArrayOptional

Refine selections that further restrict the main target — only resources matching these entries are included.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
targetTypestringOptional

Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.

selectedValuesJSON ArrayOptional

Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
idValuestringOptional

Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.

labelstringOptional

Display name of the target entity.

domainstringOptional

Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.

isTargetRemovedstringOptional

'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.

excludeTargetsJSON ArrayOptional

Refine selections that exclude resources from the main target. Returned only when the configuration explicitly excludes specific resources.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
targetTypestringOptional

Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.

selectedValuesJSON ArrayOptional

Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
idValuestringOptional

Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.

labelstringOptional

Display name of the target entity.

domainstringOptional

Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.

isTargetRemovedstringOptional

'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.

computerRefineTargetJSON ObjectOptional
Show Sub-Attributes
includeTargetsJSON ArrayOptional

Refine selections that further restrict the main target — only resources matching these entries are included.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
targetTypestringOptional

Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.

selectedValuesJSON ArrayOptional

Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
idValuestringOptional

Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.

labelstringOptional

Display name of the target entity.

domainstringOptional

Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.

isTargetRemovedstringOptional

'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.

excludeTargetsJSON ArrayOptional

Refine selections that exclude resources from the main target. Returned only when the configuration explicitly excludes specific resources.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
targetTypestringOptional

Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.

selectedValuesJSON ArrayOptional

Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.

Show Sub-Attributes
JSON Object
Show Sub-Attributes
idValuestringOptional

Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.

labelstringOptional

Display name of the target entity.

domainstringOptional

Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.

isTargetRemovedstringOptional

'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.

isExcludeServersEnabledbooleanOptional
isTechMapWithCGbooleanOptional
isTechMapWithRObooleanOptional
isUserConfigBasedOnROorWGstringOptional

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request POST \
  --url https://appdomains/dcapi/tools/shutdown/tasks \
  --header 'Accept: application/saveShutdownTask.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/shutdownTaskParams.v1+json' \
  --data '{}'

Sample Request Body

Copied!
  {
    "targetData": {
      "envType": 0,
      "targetValue": "Engineering",
      "targetType": "CustomGroup"
    },
    "scheduleJsonObj": {
      "dailyTime": "03/25/2026, 23:00",
      "scheduleType": "daily",
      "taskTimeZone": "America/New_York",
      "dailyIntervalType": "everyDay"
    },
    "taskDetails": {
      "mode": "new",
      "postPoneEnabled": true,
      "operationStr": "Shutdown",
      "shutdownTimeout": 300,
      "skipEnabled": false,
      "taskName": "Nightly Shutdown",
      "shutdownMessage": "System will shutdown in 5 minutes.",
      "taskPlatformID": 1,
      "operation": 1
    }
  }
                
Show full

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
statusstring

Result of the operation: success or failure

taskIdlong

Unique identifier of the created or saved task

Possible Response Codes

200HTTP code

Sample Response: HTTP 200

Copied!
  {
    "taskId": 5,
    "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.