Move a candidate to a stage
Move a candidate to another stage of a job.
POST https://cotlet.dev/api/v1/loxo/jobs/{job_id}/candidate/move
write Confirm
Moves the candidate as a drag and drop does, so the profile and reports show "Moved to {stage}" and no progression trigger. Use log_activity when the trigger should count. A stage with an Email Automation can start sending its emails. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| job_id integer required | integer | Job id. |
| person_id integer required | integer | Person id. |
| stage string required | string | Target stage name from list_workflow_stages. |
Request
curl -X POST https://cotlet.dev/api/v1/loxo/jobs/1/candidate/move \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"person_id":1,"stage":"stage"}'result = client.call("loxo", "move_candidate", {"job_id":1,"person_id":1,"stage":"stage"})const result = await cotlet.call('loxo', 'move_candidate', {"job_id":1,"person_id":1,"stage":"stage"});cotlet call loxo move_candidate --data '{"job_id":1,"person_id":1,"stage":"stage"}'Example response
{
"job_id": 2481530,
"person_id": 48211102,
"stage": "Interviewing",
"events": [
"Moved to Interviewing"
]
}