Move candidate to stage
Moves a candidate on a job to another pipeline stage.
POST https://cotlet.dev/api/v1/manatal/match/{match_id}/candidate-stage/move
write Confirm
Moves the match to the named stage, like dragging the card in the pipeline view. The stage must be one of the job's stages from get_job: another name fails and the error lists the stages. Any automation your account runs on a stage change runs as usual. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| match_id integer required | integer | Match ID (a candidate on one job) from list_job_pipeline. |
| stage string required | string | Target stage, named as in get_job. |
Request
curl -X POST https://cotlet.dev/api/v1/manatal/match/1/candidate-stage/move \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"stage":"stage"}'result = client.call("manatal", "move_candidate_stage", {"match_id":1,"stage":"stage"})const result = await cotlet.call('manatal', 'move_candidate_stage', {"match_id":1,"stage":"stage"});cotlet call manatal move_candidate_stage --data '{"match_id":1,"stage":"stage"}'Example response
{
"match_id": 55120,
"job_id": 3107,
"stage": "Interview",
"moved_at": "2026-10-20T11:05:00Z"
}