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

write Confirm

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

Parameters: move_application_stage
NameTypeDescription
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
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"}'
Python
result = client.call("vincere", "move_application_stage", {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"})
Node.js
const result = await cotlet.call('vincere', 'move_application_stage', {"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"});
CLI
cotlet call vincere move_application_stage --data '{"job_id":"job_8c41d2","candidate_id":"candidate_8c41d2","stage":"sent"}'

Example response

JSON

{
  "job_id": "1042",
  "candidate_id": "88251",
  "from_stage": "sent",
  "stage": "first_interview",
  "emailed": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.