# Update a Client

<mark style="color:yellow;">`PUT`</mark> `{{baseurl}}/v1/api/actors/:actorId`

This endpoint allows you to update a client, also known as an actor or entity, depending on your nomenclature. The client is an individual or a business that you have a business or commercial relationship with.&#x20;

### Header

| Name                                    | Type   | Description |
| --------------------------------------- | ------ | ----------- |
| token<mark style="color:red;">\*</mark> | String | API token   |

### **Body**

<table><thead><tr><th width="244">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>firstName<mark style="color:red;">*</mark></td><td>String</td><td>First name of the actor</td></tr><tr><td>lastName<mark style="color:red;">*</mark></td><td>String</td><td>Last name of the actor</td></tr><tr><td>middleName</td><td>String</td><td>Middle name of the actor</td></tr><tr><td>gender</td><td>String</td><td>The gender of the actor. This can be either <mark style="color:red;"><code>male or female</code></mark></td></tr><tr><td>nationality</td><td>String</td><td>The nationality type of the actor. This is the ISO alpha-2 country code: <mark style="color:red;"><code>US</code></mark></td></tr><tr><td>sourceOfIncome</td><td>String</td><td>The source of income of the actor. This can be: <mark style="color:red;"><code>earned income, investment income, interest and dividend income, rental income, business income, capital gains, retirement income, self-employment, royalty and intellectual property income, others</code></mark></td></tr><tr><td>occupation</td><td>String</td><td>The occupation of the actor</td></tr><tr><td>industry</td><td>String</td><td>The industry of the actor's occupation</td></tr><tr><td>customerSegmentation</td><td>String[]</td><td>An array of strings of actor categories based on the business customer segmentation. This can be: <mark style="color:red;"><code>high_risk, low_risk, medium_risk,</code></mark> <br><mark style="color:red;"><code>high_net_worth, high_income</code></mark></td></tr><tr><td></td><td></td><td></td></tr><tr><td>dateOfBirth<mark style="color:red;">*</mark></td><td>String</td><td>The date of birth of the actor. This is represented using the JIS format <mark style="color:red;"><code>YYYY-MM-DD</code></mark></td></tr><tr><td>accountNumbers<mark style="color:red;">*</mark></td><td>Object[]</td><td>An array of account numbers that belong to the actor</td></tr><tr><td>accountType<mark style="color:red;">*</mark></td><td>String</td><td>The type of account. It can be: <mark style="color:red;"><code>savings,current</code></mark></td></tr><tr><td>accountNumber<mark style="color:red;">*</mark></td><td>String</td><td>The account number</td></tr><tr><td>domicile</td><td>String</td><td>The country code where the account is domiciled. This is the ISO alpha-2 country code: <mark style="color:red;"><code>US</code></mark></td></tr><tr><td>accountCreationDate<mark style="color:red;">*</mark></td><td>String</td><td>The date the account number was created. This is represented using the JIS format <mark style="color:red;"><code>YYYY-MM-DD</code></mark></td></tr><tr><td>phones<mark style="color:red;">*</mark></td><td>Object[]</td><td>An array of phone numbers belonging to the actor</td></tr><tr><td>numberType</td><td>String</td><td>The type of phone number: <mark style="color:red;"><code>can be "personal" or "office"</code></mark></td></tr><tr><td>countryCode<mark style="color:red;">*</mark></td><td>String</td><td>This is the international dialling code of the corresponding country. US:<mark style="color:red;"><code>1</code></mark></td></tr><tr><td>phone<mark style="color:red;">*</mark></td><td>String</td><td>The phone number: <mark style="color:red;"><code>07100000000</code></mark></td></tr><tr><td>socials</td><td>Object[]</td><td>The array of social media accounts belonging to the actor</td></tr><tr><td>type</td><td>String</td><td>The social media platform of the social account</td></tr><tr><td>handle</td><td>String</td><td>The social media handle of the social account</td></tr><tr><td>emails<mark style="color:red;">*</mark></td><td>Object[]</td><td>The array of email addresses belonging to the actor</td></tr><tr><td>emailType</td><td>String</td><td>The type of email account: <mark style="color:red;"><code>can be, "personal" or "office"</code></mark></td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>The address of the email account</td></tr><tr><td>governmentIds<mark style="color:red;">*</mark></td><td>Object[]</td><td>The array of government IDs belonging to the actor</td></tr><tr><td>idType<mark style="color:red;">*</mark></td><td>String</td><td>Type of ID</td></tr><tr><td>value<mark style="color:red;">*</mark></td><td>String</td><td>The ID number</td></tr><tr><td>issuingAuthority</td><td>String</td><td>The organisation issuing the ID</td></tr><tr><td>expirationDate</td><td>String</td><td>The date the ID expires. This is represented using the JIS format <mark style="color:red;"><code>YYYY-MM-DD</code></mark></td></tr><tr><td>addresses<mark style="color:red;">*</mark></td><td>Object[]</td><td>The array of addresses belonging to the actor</td></tr><tr><td>addressType</td><td>String</td><td>The type of address: This can be  <mark style="color:red;"><code>home or office</code></mark></td></tr><tr><td>line1<mark style="color:red;">*</mark></td><td>String</td><td>Address line 1</td></tr><tr><td>line2</td><td>String</td><td>Address line 2</td></tr><tr><td>postCode<mark style="color:red;">*</mark></td><td>String</td><td>post/zip code of the address</td></tr><tr><td>city<mark style="color:red;">*</mark></td><td>String</td><td>Address city</td></tr><tr><td>state<mark style="color:red;">*</mark></td><td>String</td><td>Address state/province</td></tr><tr><td>country<mark style="color:red;">*</mark></td><td>String</td><td>address country</td></tr><tr><td>lengthOfStay<mark style="color:red;">*</mark></td><td>String</td><td>The length of stay at the address: <mark style="color:red;"><code>in months</code></mark></td></tr><tr><td>legalEntity<mark style="color:red;">*</mark></td><td>Object</td><td>the details of the incorporation</td></tr><tr><td>dateOfRegistration</td><td>String</td><td>The date the business was registered. This is represented using the JIS format <mark style="color:red;"><code>YYYY-MM-DD</code></mark></td></tr><tr><td>type<mark style="color:red;">*</mark></td><td>String</td><td>The type of business entity. This can be a:<br><mark style="color:red;"><code>limited_liability, sole_proprietorship, general_partnership, limited_partnership, corp, non_profit, co_op</code></mark> </td></tr><tr><td>registrationNumber<mark style="color:red;">*</mark></td><td>String</td><td>The business registration number</td></tr><tr><td>industryClasssification<mark style="color:red;">*</mark></td><td>String</td><td>The industry of the business</td></tr><tr><td>url</td><td>String</td><td>The website URL of the business</td></tr><tr><td>countryOfIncorporation</td><td>String</td><td>The country the business was incorporated. This is the ISO alpha-2 country code: <mark style="color:red;"><code>US</code></mark></td></tr><tr><td>legalEntityDirectors<mark style="color:red;">*</mark></td><td>Object[]</td><td>The details of the directors of the business</td></tr><tr><td>name<mark style="color:red;">*</mark></td><td>String</td><td>The name of the director. This is represented as: <mark style="color:red;"><code>first_name and last_name</code></mark></td></tr><tr><td>sourceOfIncome<mark style="color:red;">*</mark></td><td>String</td><td>The source of income of the director. This can be: <mark style="color:red;"><code>earned income, investment income, interest and dividend income, rental income, business income, capital gains, retirement income, self-employment, royalty and intellectual property income, others</code></mark></td></tr><tr><td>phone<mark style="color:red;">*</mark></td><td>String</td><td>The phone number of the director</td></tr><tr><td>emails<mark style="color:red;">*</mark></td><td>String[]</td><td>The array of emails belonging to the director</td></tr><tr><td>uniqueIdentifier<mark style="color:red;">*</mark></td><td>Object[]</td><td>The ID of the director</td></tr><tr><td>idType<mark style="color:red;">*</mark></td><td>String</td><td>The type of ID</td></tr><tr><td>idNumber<mark style="color:red;">*</mark></td><td>String</td><td>The number of the ID</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "middleName": "Chinedu"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Success Response for Individual" %}

```json
{
"success": true,
"statusCode": 200,
"message": "Actor updated successfully!",
"data": {
    "parentId": null,
    "isDeleted": false,
    "businessId": "628b38f03ae28a14f52d4bf7",
    "actorType": "individual",
    "firstName": "Confidence",
    "lastName": "Sunday",
    "middleName": "Chinedu",
    "dateOfBirth": "Tue Mar 05 1985 00:00:00 GMT+0000 (Coordinated Universal Time)",
    "nationality": "NG",
    "gender": "male",
    "sourceOfIncome": "business",
    "occupation": "product manager",
    "industry": "technology",
    "customerSegmentation": ["tech talents", "high profile"],
    "KycVerifiedBy": "youverify",
    "verificationId": "642eb06f0d84552686540c36",
    "accountNumbers": [
        {
            "_id": "642eb06f0d8455d0d0540c2f",
            "accountType": "savings",
            "accountNumber": "00000000000",
            "domicile": "NG",
            "accountCreationDate": "2013-09-09"
        }
    ],
    "phones": [
        {
            "_id": "642eb06f0d8455210f540c30",
            "numberType": "personal",
            "phone": "00000000000",
            "countryCode": "234"
        },
        {
            "_id": "642eb06f0d8455964a540c31",
            "numberType": "office",
            "phone": "00000000000"
        }
    ],
    "socials": [
        {
            "_id": "642eb06f0d8455652c540c32",
            "type": "twitter",
            "handle": "john_doe"
        },
        {
            "_id": "642eb06f0d8455f043540c33",
            "type": "instagram",
            "handle": "prettyJohn"
        }
    ],
    "emails": [
        {
            "_id": "642eb06f0d8455f762540c34",
            "emailType": "personal",
            "address": "johndoe@gmail.com"
        }
    ],
    "governmentIds": [
        {
            "_id": "642eb06f0d84555d43540c35",
            "idType": "nin",
            "value": "11111111111",
            "issuingAuthority": "nimc",
            "expirationDate": "20th may, 2024",
            "isVerified": true
        }
    ],
    "addresses": [
        {
            "_id": "642eb06f0d84552686540c36",
            "addressType": "home",
            "line1": "35 Wellsfargo",
            "line2": "apt 3",
            "postCode": "2222222",
            "city": "garden heights",
            "state": "New York",
            "country": "US",
            "lengthOfStay": "20",
            "dateAdded": "2023-04-06T11:43:43.507Z",
            "lastModifiedAt": "2023-04-06T11:43:43.507Z"
        }
    ],
    "createdAt": "2023-04-06T11:43:43.508Z",
    "lastModifiedAt": "2023-04-07T07:46:12.390Z",
    "_createdAt": "2023-04-06T11:43:4343+00:00",
    "_lastModifiedAt": "2023-04-07T07:46:1212+00:00",
    "id": "642eb06f0d84555c0f540c2e"
},
"links": []
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Error Response" %}

```json
{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.youverify.co/know-your-transaction-service-kyt/customer-management/update-a-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.