---
title: "Updates the surplus and surplus history for a specific account"
method: POST
path: "/v1.0/target-unit-accounts/{accountId}/buy-out-surplus/"
tags: ["Buy-out and surplus info"]
---

# Updates the surplus and surplus history for a specific account

`POST /v1.0/target-unit-accounts/{accountId}/buy-out-surplus/`

## Request

- Base URL: `http://localhost:8082/api`
- URL: `http://localhost:8082/api/v1.0/target-unit-accounts/{accountId}/buy-out-surplus/`
- Auth: HTTP bearer

## Path parameters

- `accountId` integer, required

## Request body

- SurplusUpdateDTO: Updates Surplus info
  - `newSurplusGained` string, decimal, required
  - `comments` string, required

## Response `204`

No Content

## Other responses

- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-27** `2da910b8e923`: 1 warning, 1 info
  - removed the request property `targetPeriodType`
  - api operation id `updateSurplusGained` removed and replaced with `updateAccountSurplusGained`
- **2026-04-02** `0be05036d2c8`: 3 info
  - added the new `TP7` enum value to the request property `targetPeriodType`
  - added the new `TP8` enum value to the request property `targetPeriodType`
  - added the new `TP9` enum value to the request property `targetPeriodType`
- **2025-09-11** `15b32331a1ac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/beis/apis/api-documentation/changes/v1.0/target-unit-accounts/:accountId/buy-out-surplus/post.md)

---

[API](https://skmtc.dev/beis/apis/api-documentation.md) - [All operations](https://skmtc.dev/beis/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/beis/apis/api-documentation/revisions/2da910b8e923?raw)