Move a candidate to another job
Move a candidate to another job.
POST https://cotlet.dev/api/v1/homerun/jobs/{job_id}/candidates/{candidate_id}/to-job/move
write Confirm
Moves the whole profile: CV, contact details, answers and application review stay, but stage reviews, scorecards and stage history of the old job are deleted. The candidate lands in the same stage in the new job, or in the first stage if it has no such stage. 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. |
| candidate_id string required | string | Candidate ID from list_candidates. |
| target_job_id string required | string | Job ID of the new job from list_jobs. |
Request
curl -X POST https://cotlet.dev/api/v1/homerun/jobs/job_8c41d2/candidates/candidate_8c41d2/to-job/move \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target_job_id":"target_job_8c41d2"}'result = client.call("homerun", "move_candidate_to_job", {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","target_job_id":"target_job_8c41d2"})const result = await cotlet.call('homerun', 'move_candidate_to_job', {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","target_job_id":"target_job_8c41d2"});cotlet call homerun move_candidate_to_job --data '{"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","target_job_id":"target_job_8c41d2"}'Example response
{
"candidate_id": "ap_N4pQ8sT2vX6zB1cD3eF5",
"status": "moved",
"from_job": "Office Manager",
"to_job": "Customer Success Manager",
"stage": "Application"
}