> This page is for API, version 2026-01-01 (Stable) (default). > For other versions, use one of these documentation indexes: > - 2026-01-01 (Stable) (default): https://docs.deel.wtf/api/stable/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.deel.wtf/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.deel.wtf/_mcp/server. # Create a stage move for an application POST https://api.letsdeel.com/rest/ats/applications/{application_id}/stage-moves Content-Type: application/json Advances or moves back a candidate between the lead and active stages of their job's interview plan, for callers that must never hire, archive or reject. Entering a stage can trigger that stage's job activities. Find stage ids with `GET /rest/ats/jobs/{job_id}/interview-plan-stages`. **Token scopes**: `ats:write`, `worker:write` **Beta**: this version requires the `X-Beta: true` request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-29. Reference: https://docs.deel.wtf/api/reference/endpoints/ats/move-application-between-active-interview-plan-stages-v-2026-10-29 ## Authentication - `Authorization` header (bearer token, required) — ## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.deel.training/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication) - `Authorization` header (bearer token, required) — Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/ ## Servers - `https://api.letsdeel.com/rest` (Production, default) - `https://api-staging.letsdeel.com/rest` (Demo) ## Request ### Path parameters - `application_id` (string, required) — ID of the application to move ### Headers - `X-Beta` (enum, required, default: true) — Opts in to the beta version of this endpoint. Must be `true`. - Allowed values: `true` ### Body (application/json) This endpoint expects an object. - `data` (AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaData, required) ## Response ### 201 Application moved to the stage - `data` (AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaData, required) — The application's new current interview plan stage record ## Errors ### 400 Bad Request Error Operation failed. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 401 Unauthorized Error Operation failed. - `request` (ApiErrorRequest, optional) - `errors` (list of ApiError, optional) ### 403 Forbidden Error Forbidden. ATS is not enabled for this organization or insufficient permissions. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 404 Not Found Error Not found, or not visible to the authenticated user. The two cases are indistinguishable. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 409 Conflict Error Conflict (`precondition_failed`). An `expected_*` value no longer matches the record (`field` names it): re-read the record and confirm again, never retry blindly. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 422 Unprocessable Entity Error Unprocessable entity. The target stage or the current stage of the application is in the completed category. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ### 500 Internal Server Error Operation failed. - `errors` (list of AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems, required) — List of error objects ## Types ### AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaData - `interview_plan_stage_id` (string, required) — The ID of the interview plan stage to move the application to. Stages of the completed category are rejected. - `applicable_job_activities` (list of AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaDataApplicableJobActivitiesItems, optional) — Optional array of job activities to trigger when the application enters the stage. If not provided, all activities will be triggered. If an empty array is provided, no activities will be triggered. - `expected_current_interview_plan_stage_id` (string, optional) — Optional precondition: the application's current interview plan stage ID as last read. If the application has moved since, nothing changes and a 409 precondition_failed is returned. ### AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaData The application's new current interview plan stage record - `id` (string, required) — The ID of the application's new current interview plan stage record - `created_at` (string, required) — The timestamp when the record was created - `updated_at` (string, required) — The timestamp when the record was last updated ### AtsApplicationsApplicationIdStageMovesPostResponsesContentApplicationJsonSchemaErrorsItems - `code` (string, required) — Machine-readable error code - `message` (string, required) — Human-readable error message - `field` (string, optional) — Request field related to the error, if applicable ### ApiErrorRequest - `method` (string, optional) — The HTTP method of the failed request - `url` (string, optional) — The relative URL of the failed request - `status` (double, optional) — The status code of the response - `api_req_id` (string, optional) — The request ID of the failed request - `docs` (string, optional) — A link to the official documentation for the requested endpoint resource - `source` (string, optional) — The source handler which produced the returned error - `code` (double, optional) — The code of the source handler which produced the returned error ### ApiError - `message` (string, optional) — A description of the returned error - `path` (string, optional) — The JSON path where input validation failed ### AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaDataApplicableJobActivitiesItems - `job_activity_id` (string, required) — The ID of the job activity to trigger - `participants` (list of AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaDataApplicableJobActivitiesItemsParticipantsItems, optional) — Optional array of custom participants for this activity. If not provided, the default participants from the job activity template will be used. - `candidate_self_scheduling_email_template_id` (string, optional) — Optional custom email template ID for candidate self-scheduling (only applicable for interview scheduling activities) ### AtsApplicationsApplicationIdStageMovesPostRequestBodyContentApplicationJsonSchemaDataApplicableJobActivitiesItemsParticipantsItems - `role_slug` (enum, required) — The role of the participant in the activity - Allowed values: `REVIEWER`, `INTERVIEWER` - `participant_hris_organization_user_id` (string, required) — The HRIS organization user ID of the participant ## Examples **Request** ```json { "data": { "interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" } } ``` **Response** ```json { "data": { "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479", "created_at": "2026-10-23T10:30:00Z", "updated_at": "2026-10-23T10:30:00Z" } } ``` **SDK Code** ```python import requests url = "https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves" payload = { "data": { "interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" } } headers = { "X-Beta": "true", "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves'; const options = { method: 'POST', headers: { 'X-Beta': 'true', Authorization: 'Bearer ', 'Content-Type': 'application/json' }, body: '{"data":{"interview_plan_stage_id":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves" payload := strings.NewReader("{\n \"data\": {\n \"interview_plan_stage_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n }\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-Beta", "true") req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-Beta"] = 'true' request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"data\": {\n \"interview_plan_stage_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n }\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves") .header("X-Beta", "true") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"data\": {\n \"interview_plan_stage_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n }\n}") .asString(); ``` ```php request('POST', 'https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves', [ 'body' => '{ "data": { "interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479" } }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', 'X-Beta' => 'true', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves"); var request = new RestRequest(Method.POST); request.AddHeader("X-Beta", "true"); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"data\": {\n \"interview_plan_stage_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\"\n }\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-Beta": "true", "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["data": ["interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.letsdeel.com/rest/ats/applications/faac641e-a484-4875-aed5-bfcb0a0691a0/stage-moves")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```