How to move articles to trash in Zoho Desk

Moving articles to trash in Zoho Desk is accomplished via a dedicated API endpoint that accepts a DELETE request against the Help Center articles resource, allowing you to soft-delete one or more articles without permanently removing them.

Why this matters

When managing a Zoho Desk Help Center, you may need to retire outdated or incorrect articles without losing them permanently. Sending articles to trash gives your team a safety net — content can be reviewed or restored before any final deletion. This is especially useful during content audits or when restructuring your knowledge base. As independent expert support (not official Zoho support), Beam Help walks you through exactly how this works at the API level.

Step-by-step

Step 1. Identify the helpcenter_id for the Help Center that contains the articles you want to trash. This is the unique identifier for your Zoho Desk Help Center instance and is required as a path parameter in the request. ^[5]

Step 2. Prepare your request payload. The endpoint accepts an optional parameter object (p) where you can specify which articles to target. Ensure you have the article IDs or relevant filter criteria ready before making the call. ^[5]

Step 3. Send a DELETE request to the following endpoint, substituting your actual Help Center ID:

DELETE /api/v1/helpcenter/{helpcenter_id}/articles

This operation is identified internally as deletemovearticlestotrash and its purpose is specifically to move articles to trash rather than permanently delete them. ^[5]

Step 4. If you are using the Python client, the call follows this pattern:

def delete_move_articles_to_trash(self, helpcenter_id: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/helpcenter/{helpcenter_id}/articles", p, None)

Pass your helpcenter_id as a string and supply any article-targeting parameters inside the p dictionary. ^[5]

Step 5. Confirm the response indicates a successful operation. A successful call means the targeted articles have been moved to trash within Zoho Desk — they are not permanently removed at this stage. ^[5]

Common pitfalls

• Wrong helpcenter_id: Using an incorrect or misformatted Help Center ID will cause the request to fail. Double-check the ID against your Zoho Desk portal configuration before calling the endpoint. ^[5]
• Confusing trash with permanent deletion: This endpoint moves articles to trash, not a hard delete. If your goal is permanent removal, a separate action is required after the articles are in trash. Do not assume trashed articles are gone for good. ^[5]
• Missing parameters in p: If the p parameter is left as None without the API expecting that, the request may not target the intended articles. Review what filtering or identification fields the p dictionary should contain for your specific use case. ^[5]

What to check

• Verify that the helpcenter_id used in the path matches the correct Help Center in your Zoho Desk account.
• Confirm the targeted articles now appear in the trash section of your Help Center rather than remaining in their published or draft state. ^[5]
• Ensure your API credentials have sufficient permissions to perform DELETE operations on Help Center articles within Zoho Desk. ^[5]