Permanently deletes one or more configurations from the trash. This action is irreversible.
delete /dcapi/configuration/trash/delete
https://{server-hostname}:8383/dcapi/configuration/trash/delete Copied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Array of trashed configuration collection IDs to permanently delete. Each ID must reference a configuration currently in the trash for the requesting customer. Fetch from Get Trash View . Maximum 500 entries.
curl --request DELETE \
--url https://appdomain/dcapi/configuration/trash/delete \
--header 'Accept: application/deletedConfigStatus.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/deleteConfigTrash.v1+json' \
--data '{"collectionIds":[12345,12346]}'Permanently delete trashed collections
{
"collectionIds": [
12345,
12346
]
}
Result of the operation — Success when completed successfully
Unauthorized error code: API key or OAuth token missing, expired or invalid
Authentication failure reason
All trashed collections permanently deleted
{
"status": "Success"
}
User lacks write role, scope, or customer does not own the collection
{
"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.