# Update associated persons

**PUT** `/entities/{entity_id}/associated-persons`

Update the associated persons for a business entity.

### Path Parameters

- `entity_id` `string` _(required)_ — Unique identifier for the entity.

### Body Parameters

- `associated_persons` `array of objects` _(required)_ — List of person entities associated with this business entity and their roles.
  - `ownership_percentage` `integer` — The percentage of ownership the person holds in the business (0-100).
  - `person_entity_id` `string` _(required)_ — The ID of the person entity to associate with the business entity.
  - `roles` `array of strings` _(required)_ — The roles of the person in the business. Possible values: `control_person`, `beneficial_owner`, `account_opener`, `grantor`, `trustee`, `beneficiary`, `card_holder`
  - `title_in_business` `string` — The person's title or role name within the business (e.g. "Chief Executive Officer").

**Request**

```shell
curl 'https://api.column.com/entities/<entity_id>/associated-persons' \
  -XPUT \
  -u :<YOUR API KEY> \
  -H 'Content-Type: application/json' \
  -d '{
    "associated_persons": [
      {
        "person_entity_id": "<person_entity_id>",
        "roles": ["control_person", "beneficial_owner"],
        "title_in_business": "CEO, Founder, and President"
      }
    ]
  }'
```

**Response 200**

```json
{
  "id": "enti_2dk2oXqPcB5Xb5wFpnrg50F7BeD",
  "associated_persons": [
    {
      "person_entity_id": "enti_2Q1ctiJm1NypVqCt8UBC8e4xTfH",
      "roles": [
        "control_person",
        "beneficial_owner"
      ],
      "title_in_business": "CEO, Founder, and President",
      "person_details": {
        "first_name": "Oliver",
        "last_name": "Hockey",
        "email": "oliver@column.com",
        "phone_number": "+15555555555"
      }
    }
  ]
}
```