Creates and deploys a new configuration from the specified template to the given targets. Optionally supports immediate deployment.
post /dcapi/configuration/deploy/template
https://{server-hostname}:8383/dcapi/configuration/deploy/template
Configurations.CREATECopied!
(or)
SWDeployment.CREATECopied!
(or)
PatchMgmt.CREATECopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Mandatory. The unique ID of the configuration template to deploy. Fetch from List Configuration Templates .
Mandatory. Single target descriptor identifying where the configuration should be deployed. See child keys.
Mandatory. Target type. Must be one of (lowercase): computer, user, domain, custom-group, remote-office.
Mandatory. Array of numeric resource IDs corresponding to the chosen 'type' (resource IDs for computer/user, custom-group IDs, remote-office IDs, etc.). Maximum 200 IDs per request.
Optional. Applies only when type=computer. When true, the configuration is deployed with the domain as the main target instead of the associated remote office. Defaults to false.
Optional. When true, the configuration is deployed immediately to all targets. When false (default), the configuration will be picked up by the agent in the next refresh cycle.
curl --request POST \
--url https://appdomain/dcapi/configuration/deploy/template \
--header 'Accept: application/configDeployTemplateStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/deployConfigurationTemplate.v1+json' \
--data '{"deployImmediate":true,"templateId":2001,"targets":{"isDomainMainTarget":false,"values":[301,302,303],"type":"computer"}}'Deploy template immediately to specific computer resources
{
"deployImmediate": true,
"templateId": 2001,
"targets": {
"isDomainMainTarget": false,
"values": [
301,
302,
303
],
"type": "computer"
}
}
Deploy template to a custom group (next agent refresh)
{
"templateId": 2001,
"targets": {
"values": [
9001,
9002
],
"type": "custom-group"
}
}
The unique ID of the newly created configuration collection from the template deployment.
Display name of the created configuration.
The configuration type (e.g., computer or user).
Username of the technician who initiated the deployment.
CONFIG_INVALID_INPUT_DATA: request payload is missing required fields (templateId, targets), or contains unsupported collectionType 2.
Message describing the specific validation failure in the request payload.
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
CONFIG_INVALID_INPUT_DATA: server storage limit exceeded, unable to create the configuration from template.
Message indicating insufficient storage space for the deployment.
SERVICE_NOT_AVAILABLE: unexpected error during template resolution or configuration deployment.
Message describing the internal server error encountered during deployment.
Template deployed successfully creating a new configuration
{
"configType": "computer",
"collectionId": 50001,
"addedUser": "admin",
"collectionName": "Firewall_Policy_Win11"
}
Request payload missing required templateId field
{
"error_description": "Required fields are missing in the request payload",
"error_code": "CONFIG_INVALID_INPUT_DATA"
}
CollectionType 2 is not supported by this API
{
"error_description": "The API does not support collectionType 2",
"error_code": "CONFIG_INVALID_INPUT_DATA"
}
User lacks required write role or scope
{
"error_description": "Access denied - You are not allowed to access the requested resource.",
"error_code": "UAC_UNAUTHORIZED"
}
Server storage limit exceeded
{
"error_description": "Insufficient storage space to deploy the configuration",
"error_code": "CONFIG_INVALID_INPUT_DATA"
}
Unexpected failure during template deployment
{
"error_description": "An unexpected error occurred. Please try again later.",
"error_code": "SERVICE_NOT_AVAILABLE"
}
![]()
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.