Permanently deletes the specified configuration templates. This action is irreversible.
delete /dcapi/configuration/template
https://{serverurl}/dcapi/configuration/template
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of template IDs to delete. Each must be a valid user-defined template belonging to the requesting customer. Maximum 500 entries.
curl --request DELETE \
--url https://appdomains/dcapi/configuration/template \
--header 'Accept: application/deleteTemplateStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/deleteTemplate.v1+json' \
--data '{}'Delete multiple configuration templates
{
"templateIds": [
1001,
1002,
1003
]
}
Result of the delete templates operation
Number of templates successfully deleted
BAD_REQUEST: template IDs are invalid, belong to another customer, or are system templates that cannot be deleted
Message describing the template validation failure
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
Templates deleted successfully
{
"deletedCount": 3,
"status": "Success"
}
Template IDs are invalid or belong to another customer
{
"error_description": "Invalid template IDs or templates belong to another customer",
"error_code": "BAD_REQUEST"
}
User lacks write role or attempting to delete system templates
{
"error_description": "Access denied - You are not allowed to access the requested resource.",
"error_code": "UAC_UNAUTHORIZED"
}
![]()
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.