Restores a configuration from the trash back to active state.
post /dcapi/configuration/trash/restore
https://{serverurl}/dcapi/configuration/trash/restore
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
The unique ID of the trashed configuration to restore.
curl --request POST \
--url https://appdomains/dcapi/configuration/trash/restore \
--header 'Accept: application/restoreTrashConfigStatus.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Localised message containing the restored collection name and success confirmation
SERVICE_NOT_AVAILABLE: the configuration has been deprecated and cannot be restored
Message indicating the deprecated configuration cannot be restored
Unauthorized error code: credentials missing, expired, or invalid
Authentication failure reason
INTERNAL_SERVER_ERROR: insufficient storage space to restore the configuration files
Message indicating insufficient disk space to restore the configuration
CONFIG_INTERNAL_ERROR: unexpected failure during the restore operation
Message describing the unexpected server error during restore
Configuration restored successfully from trash
{
"status": "'Firewall_Policy_Win11' has been restored successfully."
}
Configuration has been deprecated and cannot be restored
{
"error_description": "Configuration has been deprecated and cannot be restored",
"error_code": "SERVICE_NOT_AVAILABLE"
}
User lacks write role or scope
{
"error_description": "Access denied - You are not allowed to access the requested resource.",
"error_code": "UAC_UNAUTHORIZED"
}
Insufficient storage space to restore
{
"error_description": "Insufficient storage space to restore the configuration",
"error_code": "INTERNAL_SERVER_ERROR"
}
Unexpected failure during restore
{
"error_description": "Unexpected failure during the restore operation",
"error_code": "CONFIG_INTERNAL_ERROR"
}
![]()
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.