---
title: "Changes to Create Retirement"
method: POST
path: "/retirements"
---

# Changes to Create Retirement

`POST /retirements`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 11 revisions.

- **2026-08-04** `f1623e0dc2e1`: 2 info
- **2025-10-06** `656267cf681c`: 3 breaking, 1 warning, 5 info

## Changes

- **2026-08-04** `f1623e0dc2e1`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-10-06** `656267cf681c`: 3 breaking, 1 warning, 5 info
  - the `beneficiary/id` response property's maxLength was increased from `36` to `37` for the response status `200`
  - the `id` response property's maxLength was increased from `36` to `37` for the response status `200`
  - the `owner/id` response property's maxLength was increased from `36` to `37` for the response status `200`
  - added the new `insetting` enum value to the `purposes/items/` response property for the response status `200`
  - added the new `insetting` enum value to the request property `retirement_purposes/items/`
  - the `beneficiary_organisation_id` request property's maxLength was increased from `36` to `37`
  - the `credit_batch_quantities/items/credit_batch_id` request property's maxLength was increased from `36` to `37`
  - the `owner_organisation_id` request property's maxLength was increased from `36` to `37`
  - the `supplier_id` request property's maxLength was increased from `36` to `37`

---

[Operation](https://skmtc.dev/isometric/apis/isometric-registry-api/docs/retirements/post.md) - [API](https://skmtc.dev/isometric/apis/isometric-registry-api.md) - [Page](https://skmtc.dev/isometric/apis/isometric-registry-api/changes/retirements/post)