API Reference

Move an application to a stage

put
https://api.join.com/v3/applications//stage

Moves an application to a stage of its job. Read the job’s stages and send the chosen stageId.

Effects of a move

  • The target stage can schedule automated emails, just as a recruiter’s move in JOIN does.
  • Moving to a HIRED stage hires the candidate.
  • Moving to the current stage makes no change.
  • Rejected applications cannot be moved.

See Get a job to find stage IDs and Responses, errors and retries before retrying a move.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

ID of the application

Body Params
integer
required

ID of a stage from the job’s stages. Moving to the current stage leaves the application unchanged.

Headers
string

Selects a dated API revision in YYYY-MM-DD format, such as 2026-11-01. Pin this header to choose the revision explicitly; omitting it uses the server’s default. An unsupported value returns 400 unsupported_api_version. See Versions and compatibility.

Responses

Updated about 3 hours ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 3 hours ago

Did this page help you?