---
title: "Replace Mortgage Payment Allocations"
method: PUT
path: "/api/mortgage-payments/{payment_id}"
tags: ["mortgage payments"]
---

# Replace Mortgage Payment Allocations

`PUT /api/mortgage-payments/{payment_id}`

## Request

- Base URL: `https://demo.usesecuro.com` (the document declares no server; this is the origin it was published from)
- URL: `https://demo.usesecuro.com/api/mortgage-payments/{payment_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`
- TypeScript: <https://skmtc.dev/usesecuro/apis/securo/docs/api/mortgage-payments/:payment_id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `payment_id` string, uuid, required

## Headers

- `X-Workspace-Id` string, nullable

## Request body

- AllocationReplace
  - `allocations` AllocationInput[], required
    - `loan_account_id` string, uuid, required
    - `principal_amount` union, required
      - number
      - string
    - `interest_amount` union, required
      - number
      - string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `416a7752fec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usesecuro/apis/securo/changes/api/mortgage-payments/:payment_id/put.md)

---

[API](https://skmtc.dev/usesecuro/apis/securo.md) - [All operations](https://skmtc.dev/usesecuro/apis/securo/llms.txt) - [OpenAPI document](https://skmtc.dev/usesecuro/apis/securo/revisions/416a7752fec4?raw)