Endpoint: Deleting a Candidate

This endpoint lets you delete a candidate who has never interacted with the task.

A candidate can be deleted only if all of the following are true:

• The candidate has never logged into the task, whether via:
• direct access URL
• invitation code
• credential(s)
• The candidate has no ongoing or completed test instances
• The candidate's loggedIn property is false

These conditions ensure that only candidates who have not participated in any way can be deleted.

Response

Upon a successful request, a payload with an empty object will be returned.

If any of the conditions mentioned above are not met, the request is rejected with 403 Forbidden.