---
agentTools:
  projectIndex: https://docs.oysterhr.com/v0.1/llms.txt
---

# Oyster API updates - 1 September 2025

v1 Contract Changes API updates, v1 Engagements API updates

## v1 API

### v1 Contract Changes API updates

* Update includes additional objects in [Retrieve all contract changes](https://docs.oysterhr.com/reference/get_v1-contract-changes#/) and [Retrieve an individual contract change](https://docs.oysterhr.com/reference/get_v1-contract-changes-id#/) response: `bonuses`, `allowances`
* Update includes additional object arrays in [Create request](https://docs.oysterhr.com/reference/post_v1-contract-changes#/): `allowancesToAdd`, `bonusesToAdd`, `allowancesToRemove`, `allowancesToRemove`

### v1 Engagements API updates

* Release includes: [Retrieve allowances for engagement](https://docs.oysterhr.com/reference/get_v1-engagements-id-allowances#/), [Retrieve bonuses for engagement](https://docs.oysterhr.com/reference/get_v1-engagements-id-bonuses#/)