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

# /candidates/:id/relocate

`POST /candidates/{id}/relocate`

Moves a candidate to another job. 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 relocation
  - `target_job_shortcode` string, required — The shortcode of the job that the candidate will be moved to
  - `target_stage` string — The stage the candidate should be moved to

## Response `201`

201

- object
  - `candidate` object
    - `id` string
    - `url` string

## Other responses

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

---

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