Shortlist candidates
Shortlist candidates to an open job.
POST https://cotlet.dev/api/v1/vincere/jobs/{job_id}/candidates/shortlist
write Confirm
Moves the candidates to the Shortlisted stage of one open job, like Shortlist in the Candidates table. It sends nothing to the candidates or the client. A closed job, a job with no headcount left or a passed Sourcing closed date is refused, and the candidates are returned in skipped with the reason. Vincere allows 300 selected records at once. Moving a candidate back needs Remove Application in Vincere. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id string required | string | Job id from list_jobs. The job must be open. |
| candidate_ids array required | array | Candidate ids from list_candidates, up to 300. |
Request
curl -X POST https://cotlet.dev/api/v1/vincere/jobs/1042/candidates/shortlist \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"candidate_ids":["88214","88230"]}'result = client.call("vincere", "shortlist_candidates", {"job_id":"1042","candidate_ids":["88214","88230"]})const result = await cotlet.call('vincere', 'shortlist_candidates', {"job_id":"1042","candidate_ids":["88214","88230"]});cotlet call vincere shortlist_candidates --data '{"job_id":"1042","candidate_ids":["88214","88230"]}'Example response
{
"job_id": "1042",
"shortlisted": [
{
"candidate_id": "88214",
"name": "Priya Nair",
"stage": "shortlisted"
},
{
"candidate_id": "88230",
"name": "Tomas Wu",
"stage": "shortlisted"
}
],
"skipped": []
}