This article provides some information about the trash folder in the contact module.

Contact trash handling

The trash for contacts is enabled by default. To deactivate it, set:

com.openexchange.contact.trashFolder.enabled=false

Below is an overview of the contact module’s behavior when the trash is activated. With this feature, we also introduced a hardDelete parameter, which bypasses the trashing mechanism. For more details, please see HTTP-API documentation

Contacts

• Delete Contact: Moves the contact to the trash folder.
• Delete Contact from Trash: Permanently deletes the contact.
• Restore Contact: Moves the contact back to its original folder.
• Restore Contact (if the original folder was deleted): Throws an error and moves the contact to the user’s standard folder.

Folder

• Delete Folder: Contacts inside the deleted folder are moved to the trash.

Distribution list

• Trashed Contact in a Distribution List: The contact remains in the list but is converted into an independent entry without references to the original contact.

Shared and public folders

• Delete contact from shared or public folder: The contact is moved to the trash folder of the user who deleted it, if the user had sufficient permission to perform the delete operation.

CardDAV

• Deleting a contact via CardDAV results in the contact being moved to the trash folder. Although the trash folder is not synced via CardDAV and the contact seems deleted in the client, the user still can restore the contact using the web UI.