Moves one or more configurations to the trash. Trashed configurations can be restored or permanently deleted later.
post /dcapi/configuration/moveToTrash
https://{serverurl}/dcapi/configuration/moveToTrash
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Array of active configuration collection IDs to move to trash. Each ID must reference a valid active configuration belonging to the requesting customer. Fetch from Get Configurations View . Maximum 500 entries.
curl --request POST \
--url https://appdomains/dcapi/configuration/moveToTrash \
--header 'Accept: application/moveConfigToTrashStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52' \
--header 'Content-Type: application/moveConfigToTrash.v1+json' \
--data '{}'Move multiple collections to trash
{
"collectionIds": [
12345,
12346,
12347
]
}
Result of the operation — Success when all collections were moved to trash
List of configuration display names that were moved to trash
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
50001: internal server error code indicating unexpected exception in the service layer
Internal server error. Contact administrator.
All collections successfully moved to trash
{
"status": "Success",
"collectionName": [
"Firewall_Policy_Win11",
"Chrome_Settings_v2"
]
}
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"
}
Unexpected failure during the trash operation
{
"error_description": "Internal server error. Contact administrator.",
"error_code": "50001"
}
![]()
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.