Permanently deletes the specified configuration templates. This action is irreversible.
delete /dcapi/configuration/template
https://{serverurl}/dcapi/configuration/template Copied!
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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
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.