In line with our constant efforts to provide the best experience for developers, we have decided to deprecate a key used in APIs, to ensure clarity of code. This key pertains to the deletion status of resources.

When a user deletes a resource in Zoho Desk, it is only temporarily deleted -- meaning, the resource is just moved to the Recycle Bin, from where it can be restored later, if required. Permanent deletion happens only if the resource is also deleted from the Recycle Bin.

Currently, API responses return the temporary deletion status of a resource through the isDeleted Boolean key. If the value returned by this key is true, it means that the resource resides in the Recycle Bin. If the value returned is false, it means the resource resides in its respective module. However, the naming of the key seems to have led to some confusion in the developer community. Therefore, to make it clear that deleting a resource only moves it to the Recycle Bin (Trash), we are replacing isDeleted with isTrashed.

We request you to kindly update your tools to accommodate this change, so that they can continue functioning without any hassles. The isDeleted key will be completely deprecated by the end of February 2019. Therefore, please incorporate this change as soon as possible.

APIs Impacted

1.  https://desk.zoho.com/support/APIDocument.do#Tickets

2. https://desk.zoho.com/support/APIDocument.do#Contacts