---
title: "Update an existing subaccount"
method: PATCH
path: "/subaccounts/accounts/{subaccountId}"
tags: ["Subaccounts"]
---

# Update an existing subaccount

`PATCH /subaccounts/accounts/{subaccountId}`

Permissions required: **Subaccount**

Update a subaccount

## Path parameters

- `subaccountId` string, required

## Request body

- UpdateSubaccountRequest — Details of the subaccount to open for the customer
  - `beneficiaryGroup` Beneficiary[]
    - `beneficiaryAllocation` number, required
    - `beneficiaryName` string, required
    - `beneficiaryType` 'SPOUSE' | 'FAMILY_OR_FRIEND' | 'CHARITY' | 'TRUST' | 'ESTATE', required
  - `contingencyBeneficiaryGroup` Beneficiary[]
    - `beneficiaryAllocation` number, required
    - `beneficiaryName` string, required
    - `beneficiaryType` 'SPOUSE' | 'FAMILY_OR_FRIEND' | 'CHARITY' | 'TRUST' | 'ESTATE', required
  - `fees` UpdateFeeDetailType[] — List of fees to be update
    - `isBillable` boolean — Defines if a fee will be billed directly to the subaccount.
    - `rate` number — The rate should be in percentage format. The rate should be a value between 0 and 1 where 0.01 is 1%.
    - `startDate` string, date, required — The start date (inclusive) in `YYYY-MM-DD` format. This date should always be set in the future. Dates are always in UTC [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'full-date'.
    - `type` 'ADVISORY' | 'MODEL' | 'MANAGEMENT', required
  - `programSignerGroup` ProgramSigner[]
    - `programSignerEmail` string, required
    - `programSignerFirstName` string, required
    - `programSignerLastName` string, required

## Response `200`

Successfully updated the subaccount

- UpdateSubaccountResponse
  - `data` SubaccountIdResponse, required
    - `subaccountId` string, required — Unique Identifier for the subaccount

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)