---
title: "Changes to Move a candidate to a different stage or status"
method: PATCH
path: "/api/v1/projects/{projectId}/candidates/{candidateId}/move"
---

# Changes to Move a candidate to a different stage or status

`PATCH /api/v1/projects/{projectId}/candidates/{candidateId}/move`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 18 revisions.

- **2026-10-03** `cd4bc8bbd95e`: 1 info
- **2026-09-26** `bfc1118eeb5d`: 3 info

## Changes

- **2026-10-03** `cd4bc8bbd95e`: 1 info
  - added the optional property `error` to the response with the `422` status
- **2026-09-26** `bfc1118eeb5d`: 3 info
  - added the new optional request property `contract`
  - added the new optional request property `placementType`
  - added the non-success response with the status `400`

---

[Operation](https://skmtc.dev/recruitwithatlas/apis/atlas-api/docs/api/v1/projects/:projectId/candidates/:candidateId/move/patch.md) - [API](https://skmtc.dev/recruitwithatlas/apis/atlas-api.md) - [Page](https://skmtc.dev/recruitwithatlas/apis/atlas-api/changes/api/v1/projects/:projectId/candidates/:candidateId/move/patch)