Skip to main content
PUT
Move a job candidate to a stage

Authorizations

Authorization
string
header
required

Company-scoped API key. Production keys are prefixed sk_live_, sandbox keys sk_test_, each followed by 22 base62 characters (pattern ^sk_(live|test)_[0-9A-Za-z]{22}$). Generate keys in the TapTalent dashboard under Account Settings → Developers → API Key Management; a key is shown once at generation and old keys are invalidated immediately on regeneration.

Path Parameters

jobCandidateId
integer
required

The unique identifier of the job candidate.

Body

application/json

Request body for moving a job candidate to a pipeline stage.

stageId
integer
required

The ID of the pipeline stage to move the candidate to.

Response

Candidate moved to the stage successfully.

Success envelope for the move-candidate-to-stage endpoint.

status
enum<string>
required

Response status ("success").

Available options:
success
message
string
required

Success message.

Example:

"Candidate moved to stage successfully"

data
object
required