---
title: "/candidates/:id/move"
method: POST
path: "/candidates/{id}/move"
---

# /candidates/:id/move

`POST /candidates/{id}/move`

Moves the candidate to another stage. Required scope: `w_candidates`. Accessible with all token types.

## Path parameters

- `id` string, required

## Request body

- object
  - `member_id` string, required — The member perfoming the move
  - `target_stage` string — The stage the candidate should be moved to
  - `fill_reserved_requisition` boolean — When the candidate has a reserved requisition, set this to true to use that requisition. If the requisition has already a start date and the salary information (amount, frequency and currency) you don't need any additional parameters. If there is missing information, you can use the requisition key to provide it.
  - `requisition` object — In case the candidate doesn't have a reserved requisition, you can select an open, approved or on-hold requisition. You can use this object to specify which requisition to fill, and set some of its properties. You can also use this key to provide missing information from the reserved requisition.
    - `code` string — The code of the requisition you want to fill.
    - `start_date` string — The start date of the requisition.
    - `salary` object — The salary properties.
      - `amount` integer — The amount of the salary
      - `frequency` string — The frequency of the salary. Can be one of hour, day, week, month, year
      - `currency_iso` string — Can be a 3 letter ISO code for currency. Example: USD, EUR.

## Response `202`

202

## Other responses

- `401` — 401
- `404` — 404

---

[API](https://skmtc.net/workable/apis/account-root.md) · [All operations](https://skmtc.net/workable/apis/account-root/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workable/account-root/versions/3ead9ec42165/schema)