Move an application to a stage

put

https://api.join.com/v3/applications/{id}/stage

Moves an application to another stage of its job — the same move a recruiter makes in the product, including the email automations the target stage schedules. The job’s stages list the ids this accepts. Moving into the HIRED stage is the hire; there is no separate operation. Moving to the stage the application already sits in is a no-op. A rejected application cannot be moved.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The updated application

400The request could not be processed: an unsupported API version, or an unparseable JSON body.

401Authentication failed. Either the Authorization: Bearer header is missing (authentication_required), or the presented token is malformed, unknown, revoked, or belongs to a company that no longer has API access (token_invalid).

404No application with this id exists within the caller’s company. Ids belonging to other companies or to deleted applications are reported the same way, so the response never reveals which ids exist elsewhere.

422The request body failed validation, or the move was refused: the stage belongs to another pipeline (stage_not_in_pipeline), or the application is rejected (application_rejected).

429The token exceeded its sustained (600/60s) or burst (100/10s) request quota. Retry after the number of seconds in Retry-After.

500An unexpected error occurred on JOIN’s side. The request may be retried.