---
title: "Update account relationship"
method: PUT
path: "/accounts/{account_id}/relationships/{relationship_id}"
tags: ["Accounts"]
---

# Update account relationship

`PUT /accounts/{account_id}/relationships/{relationship_id}`

Update account relationship. Only relationship_type can be updated. customer_id should not be modified.

## Path parameters

- `relationship_id` string, uuid, required
- `account_id` string, uuid, required

## Request body

- AccountRelationship — The relationship of the account and the customer/business. Either customer_id OR business_id must be specified, but not both.
  - `business_id` string, uuid — Business associated with the current account. One of business_id or customer_id must be specified.
  - `created_at` string, date-time — Date and time when this association was created.
  - `customer_id` string, uuid — Personal customer associated with the current account. One of customer_id or business_id must be specified.
  - `deleted_at` string, date-time — Date and time when this association was deleted.
  - `id` string, uuid — ID of account relationship
  - `ownership_percentage` number, double — The ownership percentage of the related party.
  - `person_id` string, uuid — Person associated with the current account. This attribute is deprecated and will be removed in a future API version. Use customer_id instead.
  - `relationship_type` 'ACCOUNT_HOLDER' | 'AUTHORIZED_SIGNER' | 'AUTHORIZED_USER' | 'BENEFICIARY' | 'JOINT_ACCOUNT_HOLDER' | 'PRIMARY_ACCOUNT_HOLDER', required — Relationship type
  - `updated_at` string, date-time — Date and time when this association was last updated.

## Response `200`

Updated account relationship

- RelationshipResponse — The relationship of the account and the customer/business.
  - `account_id` string, uuid — Account ID
  - `business_id` string, uuid — Business associated with the current account. One of business_id or customer_id must be specified.
  - `created_at` string, date-time — Date and time when this association was created.
  - `customer_id` string, uuid — Personal customer associated with the current account. One of customer_id or business_id must be specified.
  - `deleted_at` string, date-time — Date and time when this association was deleted.
  - `id` string, uuid — ID of account relationship
  - `ownership_percentage` number, double — The ownership percentage of the related party.
  - `person_id` string, uuid — Person associated with the current account. This attribute is deprecated and will be removed in a future API version. Use customer_id instead.
  - `relationship_type` 'ACCOUNT_HOLDER' | 'AUTHORIZED_SIGNER' | 'AUTHORIZED_USER' | 'BENEFICIARY' | 'JOINT_ACCOUNT_HOLDER' | 'PRIMARY_ACCOUNT_HOLDER', required — Relationship type
  - `updated_at` string, date-time — Date and time when this association was last updated.

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `461` — Account has been closed

---

[API](https://skmtc.net/synctera/apis/synctera-api.md) · [All operations](https://skmtc.net/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synctera/synctera-api/revisions/b0d812e6cdd0/schema)