The Delete Unconfirmed Agents feature in Zoho Desk gives administrators a targeted way to clean up agent accounts that were invited but never completed the confirmation process.
What is it
In Zoho Desk, when a new agent is invited, they must accept the invitation and confirm their account before they can actively work on tickets. Delete Unconfirmed Agents is a dedicated operation that removes these pending, never-confirmed agent records in bulk, keeping your agent roster accurate and your license count clean. It is distinct from deleting a fully confirmed, active agent, which requires targeting a specific agent by their unique ID [1][2].
When to use it
- Post-onboarding cleanup: After a batch invitation campaign, some invitees never respond; use this operation to purge those stale pending accounts rather than letting them accumulate [1].
- License management: Unconfirmed agents may still occupy a seat or contribute to billing counts; removing them frees up capacity for new, active hires [1].
- Security hygiene: Dormant, unconfirmed accounts represent an unnecessary attack surface; deleting them reduces the risk of an old invitation link being exploited [1].
- Audit preparation: Before a compliance or access review, clearing unconfirmed agents ensures your agent list reflects only real, verified users [1].
- Organizational restructuring: When a hiring plan changes and invited candidates are no longer joining, this operation lets you reset the agent list without manually hunting down each pending record [1].
How to access it
The feature is exposed via the Zoho Desk REST API at POST /api/v1/agents/deleteUnconfirmed. You pass any required payload through the data parameter and optional query parameters through p. This is a server-side administrative action, so it requires an authenticated API call with appropriate admin-level credentials for your Desk portal [1]. For contrast, deleting a single confirmed agent uses a separate endpoint — POST /api/v1/agents/{agentid}/delete — where you supply the specific agentid of the active agent you wish to remove [2]. Both endpoints follow the same authentication and request conventions of the Zoho Desk API v1.
Related features
- Delete Confirmed Agent — removes a fully onboarded, active agent by their unique agent ID; use this when an agent has already accepted their invitation and you need to offboard them individually [2].
- Agent Management / Invite Agents — the upstream workflow that creates the unconfirmed agent records in the first place; reviewing pending invitations here before running a bulk delete is good practice.
- Roles and Profiles — once agents are confirmed, their permissions are governed by roles and profiles; auditing these after a cleanup ensures no orphaned permission sets remain.
- Agentic AI / Digital Agents — Zoho Desk's AI-powered support specialists operate alongside human agents; after tidying your human agent roster, reviewing your AI agent configuration ensures ticket routing logic stays accurate [8].