v1

latestOpenAPI 3.1.02026-07-14801408.6 KB

/candidates/:id/relocate

Moves a candidate to another job. Required scope: w_candidates. Accessible with all token types.

post/candidates/{id}/relocate

Path parameters

idstring required

The candidate's id

Request body

member_idstring required

The member perfoming the relocation

target_job_shortcodestring required

The shortcode of the job that the candidate will be moved to

target_stagestring

The stage the candidate should be moved to

Response

201

Example response

{
  "candidate": {
    "id": "3fc9a80f",
    "url": "https://groove-tech.workable.com/spi/v3/candidates/3fc9a80f"
  }
}