Move application stage
Move a candidate to the next stage of a job without sending an email.
POST https://cotlet.dev/api/v1/vincere/jobs/{job_id}/application-stage/move
Does what Move to next stage does in Vincere: stage is sent, first_interview, second_plus_interview or offer. It sends no email to the client or the candidate. Vincere does not move a candidate backward, and an offer can need approval first, so it comes back as pending_approval. Placing a candidate stays in Vincere, because it needs the placement details page. 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_job_applications. |
| stage enum required | enum | sent, first_interview, second_plus_interview or offer. |
Request
curl -X POST https://cotlet.dev/api/v1/vincere/jobs/job_8c41d2/application-stage/move \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"candidate_id":"candidate_8c41d2","stage":"sent"}' result = client.call("vincere", "move_application_stage", {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"}) const result = await cotlet.call('vincere', 'move_application_stage', {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"}); cotlet call vincere move_application_stage --data '{"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"}' Example response
{
"job_id": "1042",
"candidate_id": "88251",
"from_stage": "sent",
"stage": "first_interview",
"emailed": false
}