---
title: "Advance an Applicant"
method: PUT
path: "/v2/applicants/{id}/advance"
tags: ["Applicants", "exposeAsMcpTool"]
---

# Advance an Applicant

`PUT /v2/applicants/{id}/advance`

Advance an applicant in an opening

## Path parameters

- `id` string, required

## Request body

- object
  - `stage_id` string — Destination stage's external id. If not provided, the applicant will advance to the next stage by default.
  - `funnel_id` string — Destination funnel's external id. Required when advancing to a workflow-based stage using `stage_id`.
  - `skip_automated_actions` boolean — Set `true` if you want to skip automated actions when advancing the applicant. Defaults to `false`.
  - `rejection_reason_id` string — The external ID or ID of a rejection reason to apply when advancing the applicant.
  - `archived_reason_id` string — The external ID or ID of an archived reason to apply when advancing the applicant.
  - `validate_data` boolean — Set `true` to validate the applicant's existing data against the target stage's ValidationGroup before advancing. Returns 422 with field-level errors when invalid. Defaults to `false`.

## Response `204`

No Content

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity. - Returns `{ message }` for transition failures (e.g. applicant is already on the target stage). - When `validate_data: true` is sent and the applicant's stored data does not satisfy the target stage's ValidationGroup, returns `{ errors: { field_key: [messages] } }` with field-level errors instead.

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)