New: Kith open-sources its ATS.Read why
Skip to Content
Mutations

updatePlacement

Change the offer and placement details of a candidate on a job: who owns the placement, the salary offered, the fee, their currency, the start day and the notes, and for a hired candidate the rest of the placement (when they accepted, the fee percentage, the guarantee, the invoice, who shares the credit, the referral and whether it fell through; NOT_A_PLACEMENT for a candidate not at the hired stage). A field left out is unchanged, and null clears it. The change is refused with STALE_VERSION when the placement's details have changed since the placementVersion given, so a blind repeat of a saved change is refused too; Kith ATS grading or re-ranking the place meanwhile is not a change to them.

updatePlacement(
  input: UpdatePlacementInput!
): UpdatePlacementPayload!

Arguments

updatePlacement.input · UpdatePlacementInput! non-null input

The offer and placement details to set.

Type

UpdatePlacementPayload object

The changed placement.