Move a candidate to a step
POST/v1/flows/:flow_id/candidates/:candidate_id/move
Sends the candidate to a different step of the flow. Steps between are not sent.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Candidate moved
Missing or invalid bearer token.
The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to edit this flow, or the API key lacks the flows:write scope (err_insufficient_scope).
Flow not found (err_flow_not_found), or the candidate is not in the flow (err_candidate_not_in_flow).
Validation failed. Error codes:
err_step_not_found- the step is not in this flowerr_step_not_active- the step is archivederr_flow_not_active- the flow is not activeerr_invalid_step_transition- the candidate cannot be moved to that step from where they areerr_on_behalf_of_not_allowed- a personal access token passed another user's IDerr_user_not_found-on_behalf_ofis not an active user in the accounterr_on_behalf_of_forbidden- that user is not allowed to perform this action