Creates a new deployment policy template with deployment window, pre-deployment, and post-deployment configurations.
post /dcapi/patch/deploymentPolicy
https://{server-hostname}:8383/dcapi/patch/deploymentPolicy
PatchMgmt.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Unique identifier of the deployment policy template
Name of the deployment policy template
Description of the deployment policy template
Whether this template is currently in use
Whether associated with a specific module
File size associated with the template in bytes
Deployment window configuration
Week type for scheduling
Deployment option type
Whether staging is enabled
Timezone for deployment window (e.g., Asia/Kolkata)
List of deployment window schedule entries
Start time in HH:mm format
Stop time in HH:mm format
Days of the week (1-7)
Weeks of the month (1-5)
Months of the year (0-11)
Dates of the month (1-31)
List of pre-deployment activity configurations
Configuration type: WOL_CONFIG, PRE_REBOOT_CONFIG, CUSTOM_SCRIPT_CONFIG, PRE_USER_NOTIFICATION_CONFIG
Continue deployment if this step fails
Skip deployment on success
Enable Wake-on-LAN (WOL_CONFIG only)
Notify user before pre-reboot (PRE_REBOOT_CONFIG)
Exclude servers from reboot (PRE_REBOOT_CONFIG)
Skip reboot when not required (PRE_REBOOT_CONFIG)
Reboot notification dialog title (PRE_REBOOT_CONFIG)
Reboot notification message (PRE_REBOOT_CONFIG)
Reboot notification timeout in seconds (PRE_REBOOT_CONFIG)
Script file name (CUSTOM_SCRIPT_CONFIG)
Description of the script (CUSTOM_SCRIPT_CONFIG)
Script arguments (CUSTOM_SCRIPT_CONFIG)
Comma-separated expected exit codes (CUSTOM_SCRIPT_CONFIG)
Unique script identifier (CUSTOM_SCRIPT_CONFIG)
Platform: 1=Windows, 2=Mac, 3=Linux (CUSTOM_SCRIPT_CONFIG)
List of dependency files (CUSTOM_SCRIPT_CONFIG)
Dependency file name
Unique file identifier
URL to the dependency file
Status of the file
Notification title (PRE_USER_NOTIFICATION_CONFIG)
Notification message (PRE_USER_NOTIFICATION_CONFIG)
Notification timeout in seconds (PRE_USER_NOTIFICATION_CONFIG)
Allow users to skip deployment (PRE_USER_NOTIFICATION_CONFIG)
Force deployment if user skipped (PRE_USER_NOTIFICATION_CONFIG)
Days after which to force deployment (PRE_USER_NOTIFICATION_CONFIG)
Start deployment without notification (PRE_USER_NOTIFICATION_CONFIG)
System idle timeout in seconds (PRE_USER_NOTIFICATION_CONFIG)
Show deployment progress (PRE_USER_NOTIFICATION_CONFIG)
List of post-deployment activity configurations
Configuration type: CUSTOM_SCRIPT_CONFIG, POST_REBOOT_SHUTDOWN_CONFIG
Continue if this step fails
Skip on success
Script file name (CUSTOM_SCRIPT_CONFIG)
Description of the script (CUSTOM_SCRIPT_CONFIG)
Script arguments (CUSTOM_SCRIPT_CONFIG)
Expected exit codes (CUSTOM_SCRIPT_CONFIG)
Script identifier (CUSTOM_SCRIPT_CONFIG)
Platform: 1=Windows, 2=Mac, 3=Linux (CUSTOM_SCRIPT_CONFIG)
Dependency files (CUSTOM_SCRIPT_CONFIG)
Dependency file name
Unique file identifier
URL to the dependency file
Status of the file
0=Do Nothing, 1=Reboot, 2=Shutdown (POST_REBOOT_SHUTDOWN_CONFIG)
1=Force, 2=Postpone (POST_REBOOT_SHUTDOWN_CONFIG)
1=Immediately, 2=Window Specified (POST_REBOOT_SHUTDOWN_CONFIG)
Reboot notification title (POST_REBOOT_SHUTDOWN_CONFIG)
Reboot notification message (POST_REBOOT_SHUTDOWN_CONFIG)
Notification timeout in seconds (POST_REBOOT_SHUTDOWN_CONFIG)
Skip reboot when not required (POST_REBOOT_SHUTDOWN_CONFIG)
Exclude servers from reboot (POST_REBOOT_SHUTDOWN_CONFIG)
Reboot window schedule (POST_REBOOT_SHUTDOWN_CONFIG)
Start time in HH:mm format
Stop time in HH:mm format
Days of the week (1-7)
Weeks of the month (1-5)
Months of the year (0-11)
Dates of the month (1-31)
curl --request POST \
--url https://appdomain/dcapi/patch/deploymentPolicy \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'content-type: application/json' \
--data '{"preDeploymentDetails":[{"configName":"WOL_CONFIG","performNoDeploymentSuccess":false,"isWOLEnabled":true,"proceedOnFailure":true}],"deploymentDetails":{"enableStaging":false,"weekType":1,"deploymentOption":1,"timeZone":"Asia/Kolkata","deploymentWindowSchedule":[{"weeks":["1","2","3","4"],"months":["0","1","2"],"days":["1","2","3","4","5"],"startTime":"09:00","stopTime":"18:00","dates":["1","15"]}]},"postDeploymentDetails":[{"configName":"POST_REBOOT_SHUTDOWN_CONFIG","rebootNotificationMessage":"System will reboot after patching.","rebootPreference":1,"rebootNotificationTitle":"Reboot Required","rebootMethod":1,"rebootWindowSchedule":[{"days":["6","7"],"startTime":"02:00","stopTime":"05:00"}],"skipRebootIfNotRequired":true,"forceRebootOption":1,"rebootNotificationTimeout":300,"excludeRebootForServers":true}],"templateName":"My Deployment Policy","templateDesc":"Description of the policy","filesize":1024}'Create a deployment policy with deployment window and pre/post activities
{
"preDeploymentDetails": [
{
"configName": "WOL_CONFIG",
"performNoDeploymentSuccess": false,
"isWOLEnabled": true,
"proceedOnFailure": true
}
],
"deploymentDetails": {
"enableStaging": false,
"weekType": 1,
"deploymentOption": 1,
"timeZone": "Asia/Kolkata",
"deploymentWindowSchedule": [
{
"weeks": [
"1",
"2",
"3",
"4"
],
"months": [
"0",
"1",
"2"
],
"days": [
"1",
"2",
"3",
"4",
"5"
],
"startTime": "09:00",
"stopTime": "18:00",
"dates": [
"1",
"15"
]
}
]
},
"postDeploymentDetails": [
{
"configName": "POST_REBOOT_SHUTDOWN_CONFIG",
"rebootNotificationMessage": "System will reboot after patching.",
"rebootPreference": 1,
"rebootNotificationTitle": "Reboot Required",
"rebootMethod": 1,
"rebootWindowSchedule": [
{
"days": [
"6",
"7"
],
"startTime": "02:00",
"stopTime": "05:00"
}
],
"skipRebootIfNotRequired": true,
"forceRebootOption": 1,
"rebootNotificationTimeout": 300,
"excludeRebootForServers": true
}
],
"templateName": "My Deployment Policy",
"templateDesc": "Description of the policy",
"filesize": 1024
}
Unique identifier of the created deployment policy template
Operation result: success
Error code: CONFIG_DEPLOY_POLICY_INVALID for storage limit exceeded
Storage limit exceeded message
Deployment policy created
{
"templateID": 12345,
"status": "success"
}
Storage limit exceeded
{
"error_description": "Storage limit exceeded",
"error_code": "CONFIG_DEPLOY_POLICY_INVALID"
}
![]()
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.