---
title: "Update a person's account mapping association."
method: PATCH
path: "/v1/persons/{person_id}/deposit_accounts/{account_id}/mappings"
tags: ["Savings Accounts"]
---

# Update a person's account mapping association.

`PATCH /v1/persons/{person_id}/deposit_accounts/{account_id}/mappings`

Modifies the existing mapping configuration for a person’s savings account. 
    This endpoint allows for the transition of the main account association 
    or the adjustment of interest rate tiers. 
    **Note:** Use this endpoint only for accounts that have already been 
    initially mapped via the POST method.

## Path parameters

- `person_id` string, required
- `account_id` string, required

## Request body

- UpdateDepositAccountsMappingsRequest — The request payload for updating the mapping of a savings account.
  - `main_account_iban` string — IBAN of the external main account.
  - `deposit_type` 'SAVINGS_ACCOUNT', required — The account type.
  - `interest_tier` 'INTEREST_BASE_TIER' | 'INTEREST_TIER_1' | 'INTEREST_TIER_2' | 'INTEREST_TIER_3' | 'INTEREST_TIER_4' | 'INTEREST_TIER_5' — Tier to which the savings account belongs. **Note:** If you've configured multiple standard interest rates (tiered interest rates), send the interest tier value in this field. If no value is sent, the system will default to the base tier.

## Response `200`

The mapping update was successful.

- UpdateDepositAccountsMappingsResponse — Response schema for updates to the mapping of a savings account to a main account.
  - `id` string, required — ID of the mapping between the main account and the savings account.
  - `main_account_iban` string, required — IBAN of the external main account.
  - `status` 'OPENED' | 'TAX_REGISTERED' | 'ACTIVE' | 'INACTIVE' | 'FAILED', required — The current status of the savings account.
  - `deposit_type` 'SAVINGS_ACCOUNT', required — The account type.
  - `interest_tier` 'INTEREST_BASE_TIER' | 'INTEREST_TIER_1' | 'INTEREST_TIER_2' | 'INTEREST_TIER_3' | 'INTEREST_TIER_4' | 'INTEREST_TIER_5' — Tier to which the savings account belongs. **Note:** If you've configured multiple standard interest rates (tiered interest rates), send the interest tier value in this field. If no value is sent, the system will default to the base tier.

## Other responses

- `400` — An error occurred on the client side.
- `403` — You are not authorized to perform this action.
- `404` — The provided resource could not be found.
- `409` — Conflict.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)