Update pension scheme
Partially update a workplace pension scheme. Creates a new configuration version effective from valid_from. Only provided fields are updated. Returns 404 if the scheme does not exist.
Body
Create a new version of the pension scheme configuration effective from valid_from.
Only include fields that should change — unset fields are inherited from the current version.
valid_from is required and must be strictly later than the current version's valid_from.
Response
Successful Response
Organisation's pension scheme configuration.
scheme_id is the stable handle identifier — use it in {scheme_id} path segments
and in membership scheme_id fields. valid_from/valid_to describe the validity
window of this particular configuration version.
Earnings base for contribution calculation: QUALIFYING_EARNINGS (band £6,240–£50,270/year, 2025-26), PENSIONABLE_PAY (full pay, no lower threshold)
QUALIFYING_EARNINGS, SET_1_BASIC_PAY, SET_2_BASIC_PAY_85, SET_3_TOTAL_PAY, PENSIONABLE_PAY