Creates and deploys a new system tools collection task. Accepts a JSON body specifying the task label, description, tools to run (Check Disk, Defragmenter, Disk Cleanup, Task Scheduler), target computers or groups, and schedule configuration.
post /dcapi/tools/systemTools/tasks/deploy
https://{serverurl}/dcapi/tools/systemTools/tasks/deploy
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Refine selections that further restrict the main target — only resources matching these entries are included.
Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.
Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.
Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.
Display name of the target entity.
Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.
'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.
Refine selections that exclude resources from the main target. Returned only when the configuration explicitly excludes specific resources.
Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.
Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.
Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.
Display name of the target entity.
Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.
'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.
Refine selections that further restrict the main target — only resources matching these entries are included.
Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.
Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.
Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.
Display name of the target entity.
Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.
'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.
Refine selections that exclude resources from the main target. Returned only when the configuration explicitly excludes specific resources.
Numeric target-type code returned as a string. Common values: 1=Domain, 2=Remote Office, 5=Custom Group, 7=User, 8=Computer.
Array of the selected target entities (Remote Offices, Computers, Users, etc.) belonging to this targetType.
Unique identifier of the target entity (resource ID, Remote Office ID, Custom Group ID, Domain ID, etc.) returned as a string.
Display name of the target entity.
Active Directory domain or Workgroup name of the entity. Returned only for Computer or User entries.
'true' if the target entity no longer exists in the customer's environment but is still referenced by the configuration; otherwise 'false'.
curl --request POST \
--url https://appdomains/dcapi/tools/systemTools/tasks/deploy \
--header 'Accept: application/collectionDeployStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/collectionDetails.v1+json' \
--data '{"description":"Automate disk cleanup for Engineering team","label":"Weekly Disk Cleanup"}' {
"deployAction": "Deploy",
"configDetails": [
{
"toolDetails": {
"temporaryFiles": true,
"internetCacheFiles": false,
"recycleBin": true
}
}
],
"description": "Automate disk cleanup for Engineering team",
"label": "Weekly Disk Cleanup",
"targetDetails": {
"envType": 0,
"targetValue": "Engineering",
"targetType": "CustomGroup"
},
"rebootClientComputers": "0"
}
Result of the create or update operation: success or failure
Unique identifier of the created or updated task collection
{
"collectionId": 15,
"status": "success"
}
![]()
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.