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 Copied!
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 returned when authentication credentials are missing, expired, or invalid (authentication=required)
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.