Delete an applicant
Deletes an applicant and their résumé for good.
Free
This tool costs nothing to call.
An example
Jan Kowalski asked us to delete his application. Remove it and his CV.
Your agent callshiring_delete_applicantFree
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"applicant_id": 4102
}Use it when
A candidate asks to be forgotten. Applicants go on their own 12 months after their last change.
What it does
Delete an applicant and their résumé for good, for example when they ask to be forgotten. Applicants are deleted on their own 12 months after their last change.
What comes back
deleted: the applicant_id. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
applicant_idRequired | integer | At least 1. |
The call
Over MCP, call hiring_delete_applicant on https://api.conecto.chat/mcp/hiring. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hiring_delete_applicant \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"applicant_id":4102}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No applicant of the business has that applicant_id. | Find them with hiring_list_applicants. |
More Hiring tools
All 25 tools- Set up the careers page
hiring_setup_careersSets up the careers page at cncto.co/j/<name>: its name, intro, website, reply-to address and who hears about applications.$0.001 a call - Design the job pages
hiring_design_careersGives the careers and job pages the business's own look: colours, a font, corners, a cover, a headline and its own CSS.$0.001 a call - Post a job
hiring_create_jobPosts a job with its own page and application form on the careers page.$0.01 a call - Change a job
hiring_update_jobChanges a job's details, its criteria and filter, or opens or closes it.$0.01 a call - List jobs
hiring_list_jobsThe business's jobs with their status, page and applicants per stage.Free* - List applicants
hiring_list_applicantsApplicants, newest or best match first: for one job or all, by stage, screening, risk, name or email, or the ones kept as spam.Free* - Read an application
hiring_get_applicantOne application in full: answers, résumé link, screening and match score, the checks on who sent it, notes and history.Free* - Applications to screen
hiring_screen_queueThe next applications nobody has screened, with the job's criteria and the résumé as text, blind by default.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md