Skip a candidate's current step
POST/v1/flows/:flow_id/candidates/:candidate_id/skip
Gives up on the step the candidate is halted at and moves them to the next one.
Request
Responses
- 200
- 401
- 403
- 404
- 422
Step skipped
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_flow_not_active- the flow is neither active nor pausederr_step_not_found- the step is not in this flowerr_step_not_active- the step is archivederr_step_mismatch- the candidate is not halted at this steperr_flow_candidate_not_failed- nothing is halted for this candidateerr_candidate_has_application_for_job- the candidate already has an application in the flow's joberr_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