Fast-forward a candidate to a later node

post

https://hivemind.hr/api/public/v1/candidates/{id}/fast-forward

Move the candidate forward in the pipeline to a target node.
Existing responses are preserved; the candidate's current_node_id
is updated and pipeline-automation nodes between current and
target are not executed (use the UI to replay automation).

Direction rules

target_node_id must be a descendant of the candidate's
current node. Trying to fast-forward to the current node or to a
node behind it returns 422.
To move backward, use POST /candidates/:id/rewind.

Side effects

Credits are deducted for the target node's type.
The candidate receives a "your application has progressed" email
unless notify_candidate: false is sent.

Dry run

Send dry_run: true to validate the move without applying any
change. (Useful even though no responses are deleted, since it
also exercises the ordering check.)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

uuid

required

Candidate UUID.

Body Params

target_node_id

uuid

required

UUID of the target node. Must match an entry in
pipeline.nodes[].id for the candidate's pipeline.

dry_run

boolean

Defaults to false

If true, return the would-be result without applying any
change — no DB writes, no credit deduction, no email sent.
applied in the response will be false.

notify_candidate

boolean

Defaults to true

If true (default), the candidate receives a "your application
has progressed" email after the move. Set to false to perform
silent moves (e.g., bulk operations or backfills).

Headers

Idempotency-Key

string

^[A-Za-z0-9_-]{8,64}$

Optional. Send the same key on a retry to make the request
idempotent. The first successful 2xx response is cached for
24 hours; subsequent retries with the same key return the
cached response with Idempotent-Replay: true. Reusing a key
with a different request body returns 409
idempotency_conflict. Format: 8–64 chars of [A-Za-z0-9_-]
— a UUID v4 is a fine default.

Responses

200Move applied, or — for dry_run: true — preview returned. deleted_responses is always [] on this endpoint.

400Malformed request (validation, bad UUID, unknown filter, etc.).

401Missing, malformed, or invalid API key.

402Insufficient credits to cover the target node's type.

404Candidate not found OR target_node_id does not match a node in the candidate's pipeline.

409Another request moved this candidate between your read of the candidate's current_node_id and your move call. Refetch the candidate and retry the move.

422Disallowed move — typically target_must_follow_current if the target is behind or equal to the current node, or candidate_has_no_current_node for a freshly-created candidate.

429Rate limit exceeded. Retry after Retry-After seconds.

500Unexpected server-side error. Log the request_id and contact support.