---
title: "Update a placement"
method: PUT
path: "/placements/{placementId}"
tags: ["Placement API:Placements"]
---

# Update a placement

`PUT /placements/{placementId}`

## Path parameters

- `placementId` integer, required

## Request body

- UpdatePlacementCommand
  - `jobTitle` string, nullable, required
  - `contactId` integer, nullable
  - `summary` string, nullable
  - `statusId` integer, nullable — Placement status
  - `paymentType` string, nullable
  - `startDate` string, date — Date employment begins
  - `endDate` string, date, nullable — Date a contract or temporary employment ends
  - `salary` SubmitPlacementSalaryModel
    - `base` number, double
    - `superannuation` number, double
    - `total` number, double
    - `fee` number, double
  - `contractRate` SubmitPlacementContractRateModel
    - `ratePer` 'Hour' | 'Day', string
    - `hoursPerWeek` number, double
    - `daysPerWeek` number, double
    - `clientRate` number, double
    - `candidateRate` number, double
    - `onCostsType` 'Fixed' | 'Percent', string
    - `onCosts` number, double
    - `netMargin` number, double
  - `award` string, nullable
  - `industryCode` string, nullable
  - `billing` SubmitPlacementBillingModel
    - `contactId` integer, nullable
    - `addressId` string, uuid, nullable
    - `email` string, nullable
    - `orderRef` string, nullable — PO Number/Reference
    - `invoiceRef` string, nullable — Invoice Number/Reference
    - `terms` string, nullable — Billing payment terms
    - `dueDate` string, date, nullable — Payment due date
  - `feeSplit` 'Fixed' | 'Percent', string
  - `recruiters` SubmitPlacementRecruiterModel[], nullable
    - `userId` integer — Recruiter to be associated with the placement, must also be associated with the related job.
    - `feeSplit` number, double, nullable — Optional fee portion, 0.0-1.0 (representing 0%-100%) if placement feeSplit='Percent', a currency amount if placement feeSplit='Fixed'
  - `custom` SubmitCustomFieldValueModel[], nullable
    - `fieldId` integer, required
    - `value` unknown

## Response `200`

Placement was successfully updated

## Other responses

- `404` — Placement was not found
- `422` — Validation error

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/versions/9f43f6a6ee6e/schema)