> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intermezzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Change an employee

> Keep employee details up to date, from any date.

People move house, get a new tax code or change their hours. You record each change from the date it applies, one satellite at a time, and Intermezzo keeps the history. The rules are in [Changing data](https://docs.intermezzo.ai/preview/concepts/changing-data.md); this page walks through the common cases.

## Example: the tax code changes from 1 December

**1. Read the satellite**

```http Request theme={null}
GET /gb/organizations/{organization_id}/employees/{employee_id}/tax
```

```http Response theme={null}
200 OK
ETag: "6947"

{
  "valid_from": "2026-04-06",
  "valid_to": "9999-12-31",
  "tax_code": "1257L",
  "…": "…"
}
```

**2. Send the whole satellite from the new date**

Send every field of `tax`, with `valid_from` set to the date of the change and `If-Match` set to the `ETag` you read.

```http Request theme={null}
PUT /gb/organizations/{organization_id}/employees/{employee_id}/tax
If-Match: "6947"
```

```json Request body highlight={2,4} theme={null}
{
  "valid_from": "2026-12-01",
  "valid_to": "9999-12-31",
  "tax_code": "1263L",
  "rti_id": "100234",
  "student_loan_type": "PLAN_2",
  "postgraduate_loan": false,
  "p45_gross_pay": "0.00",
  "p45_tax_amount": "0.00",
  "starter_details": { "basis": "DECLARATION", "declaration": "A" }
}
```

**3. Check the timeline**

The `PUT` returns `200` with the new edition. [Get Tax Editions](https://docs.intermezzo.ai/api-reference/preview/great-britain/get-tax-editions.md) now shows `1257L` from `2026-04-06` to `2026-12-01`, and `1263L` from `2026-12-01`.

HMRC also changes `tax`. When HMRC sends a new tax code or a student loan notice, Intermezzo writes a new edition with `created_by` set to the notice, for example `hmrc:P6`. If that happens between your `GET` and your `PUT`, the `PUT` returns `412 EDITION_MISMATCH`: read the satellite again and decide whether your change still applies.

The other satellites work the same way: [Create Core Edition](https://docs.intermezzo.ai/api-reference/preview/great-britain/create-core-edition.md), [Create Address Edition](https://docs.intermezzo.ai/api-reference/preview/great-britain/create-address-edition.md), [Create Job Edition](https://docs.intermezzo.ai/api-reference/preview/great-britain/create-job-edition.md), [Create Insurance Edition](https://docs.intermezzo.ai/api-reference/preview/great-britain/create-insurance-edition.md), [Create Bank Edition](https://docs.intermezzo.ai/api-reference/preview/great-britain/create-bank-edition.md).

## Standing pay

Salary and other pay that is paid every period lives in the `compensation` satellite; see [Compensation](https://docs.intermezzo.ai/preview/gb/employees/compensation.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.