---
title: "Updates the surplus and surplus history for a specific facility"
method: POST
path: "/v1.0/facilities/{facilityId}/buy-out-surplus/"
tags: ["Buy-out and surplus info"]
---

# Updates the surplus and surplus history for a specific facility

`POST /v1.0/facilities/{facilityId}/buy-out-surplus/`

## Request

- Base URL: `http://localhost:8082/api`
- URL: `http://localhost:8082/api/v1.0/facilities/{facilityId}/buy-out-surplus/`
- Auth: HTTP bearer

## Path parameters

- `facilityId` 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 info
  - endpoint added

[Operation history](https://skmtc.dev/beis/apis/api-documentation/changes/v1.0/facilities/:facilityId/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)