# UpdatePlacementInput (/api/reference/inputs/update-placement-input)

The offer and placement details to set. A field left out is unchanged; null clears it, except the currency and `isReferralPaid`. The fields from `offerAcceptedAt` on are a placement's alone: they are refused with `NOT_A_PLACEMENT` unless the candidate is at the hired stage.

```graphql
input UpdatePlacementInput {
  currency: String
  expectedVersion: String!
  feePercent: Decimal
  fellThroughAt: Date
  fellThroughReason: String
  guaranteeDays: Int
  invoiceDate: Date
  invoiceStatus: PlacementInvoiceStatus
  isReferralPaid: Boolean
  jobCandidateId: ID!
  notes: String
  offerAcceptedAt: Date
  offerSalary: Decimal
  ownerId: ID
  paidDate: Date
  placementFee: Decimal
  referralFee: Decimal
  referralPersonId: ID
  splits: [PlacementSplitInput!]
  startDate: Date
}
```

### Fields [#fields]

#### [`UpdatePlacementInput.currency`](#currency) · [`String`](/api/reference/scalars/string) `scalar` [#currency]
The currency of both amounts, as a three-letter ISO 4217 code in upper case, such as `GBP`. It cannot be cleared.

#### [`UpdatePlacementInput.expectedVersion`](#expected-version) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#expected-version]
The `placementVersion` of the place you read. The change is refused with `STALE_VERSION` if the placement's details have changed since; Kith ATS grading or re-ranking the place does not change it.

#### [`UpdatePlacementInput.feePercent`](#fee-percent) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#fee-percent]
The fee as a percentage of the salary, from 0 to 100, such as `22.5`.

#### [`UpdatePlacementInput.fellThroughAt`](#fell-through-at) · [`Date`](/api/reference/scalars/date) `scalar` [#fell-through-at]
The day the candidate left inside the guarantee.

#### [`UpdatePlacementInput.fellThroughReason`](#fell-through-reason) · [`String`](/api/reference/scalars/string) `scalar` [#fell-through-reason]
Why the placement fell through. Blank clears it.

#### [`UpdatePlacementInput.guaranteeDays`](#guarantee-days) · [`Int`](/api/reference/scalars/int) `scalar` [#guarantee-days]
How many days the guarantee runs from the start. Kith ATS works out its last day.

#### [`UpdatePlacementInput.invoiceDate`](#invoice-date) · [`Date`](/api/reference/scalars/date) `scalar` [#invoice-date]
The day the invoice was sent.

#### [`UpdatePlacementInput.invoiceStatus`](#invoice-status) · [`PlacementInvoiceStatus`](/api/reference/enums/placement-invoice-status) `enum` [#invoice-status]
Where the invoice stands.

#### [`UpdatePlacementInput.isReferralPaid`](#is-referral-paid) · [`Boolean`](/api/reference/scalars/boolean) `scalar` [#is-referral-paid]
True once the referral fee has been paid. It cannot be cleared: give false.

#### [`UpdatePlacementInput.jobCandidateId`](#job-candidate-id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#job-candidate-id]
The id of the candidate's place on the job.

#### [`UpdatePlacementInput.notes`](#notes) · [`String`](/api/reference/scalars/string) `scalar` [#notes]
The recruiter's notes on them for this job. Blank clears them.

#### [`UpdatePlacementInput.offerAcceptedAt`](#offer-accepted-at) · [`Date`](/api/reference/scalars/date) `scalar` [#offer-accepted-at]
The day the candidate accepted the offer.

#### [`UpdatePlacementInput.offerSalary`](#offer-salary) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#offer-salary]
The salary offered, zero or more, such as `85000.00`.

#### [`UpdatePlacementInput.ownerId`](#owner-id) · [`ID`](/api/reference/scalars/id) `scalar` [#owner-id]
The teammate responsible for the placement. Null for nobody.

#### [`UpdatePlacementInput.paidDate`](#paid-date) · [`Date`](/api/reference/scalars/date) `scalar` [#paid-date]
The day the invoice was paid.

#### [`UpdatePlacementInput.placementFee`](#placement-fee) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#placement-fee]
The fee for the placement, zero or more.

#### [`UpdatePlacementInput.referralFee`](#referral-fee) · [`Decimal`](/api/reference/scalars/decimal) `scalar` [#referral-fee]
The fee owed to whoever referred them, zero or more, in `currency`.

#### [`UpdatePlacementInput.referralPersonId`](#referral-person-id) · [`ID`](/api/reference/scalars/id) `scalar` [#referral-person-id]
The person, from the workspace's people, who referred the candidate. Null for nobody.

#### [`UpdatePlacementInput.splits`](#splits) · [`[PlacementSplitInput!]`](/api/reference/inputs/placement-split-input) `list` `input` [#splits]
Who shares the credit, replacing what is there; null or an empty list for nobody. Each teammate once, 20 at most, 100 percent at most together.

#### [`UpdatePlacementInput.startDate`](#start-date) · [`Date`](/api/reference/scalars/date) `scalar` [#start-date]
The day they start.

### Member Of [#member-of]

[`updatePlacement`](/api/reference/mutations/update-placement)  `mutation`