# updatePlacement (/api/reference/mutations/update-placement)

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.

```graphql
updatePlacement(
  input: UpdatePlacementInput!
): UpdatePlacementPayload!
```

### Arguments [#arguments]

#### [`updatePlacement.input`](#input) · [`UpdatePlacementInput!`](/api/reference/inputs/update-placement-input) `non-null` `input` [#input]
The offer and placement details to set.

### Type [#type]

#### [`UpdatePlacementPayload`](/api/reference/objects/update-placement-payload) `object` [#updateplacementpayload-object]
The changed placement.