# updateSubject

This method is to update an existing subject.

_This method was added in Cortex 2.1_

## Parameters

| Name        | Type               | Required | Description                                                                                                               |
| ----------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| cortexToken | `string`           | yes      | A token returned by [authorize](../authentication/authorize).                                                             |
| subjectName | `string`           | yes      | The name of the subject.                                                                                                  |
| dateOfBirth | `string`           | no       | The date of birth of the subject. The format must be "YYYY-MM-DD", e.g. "1980-12-25".                                     |
| sex         | `string`           | no       | Must be "M", "F" or "U". These letters stands for male, female and unknown respectively.                                  |
| countryCode | `string`           | no       | The [Alpha-2 ISO code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes) of the country the subject lives in. |
| state       | `string`           | no       | The state the subject lives in.                                                                                           |
| city        | `string`           | no       | The city the subject lives in.                                                                                            |
| attributes  | `array of objects` | no       | A list of demographic attribute objects. See [Subject object](subject-object).                                            |

A subject is identified by his/her name, so you must provide the name of the subject you want to update. Then you can set one or more of the not required fields to update their value.

## Result

The result is a [subject object](subject-object) representing the updated subject.

## Examples

Update the date of birth of a subject.

{% tabs %}
{% tab title="Request" %}
```javascript
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "updateSubject",
    "params": {
        "cortexToken": "xxx",
        "subjectName": "Bob Smith",
        "dateOfBirth": "1978-11-21"
    }
}
```
{% endtab %}

{% tab title="Response" %}
```javascript
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "attributes": [],
        "city": "",
        "countryCode": "",
        "countryName": "",
        "dateOfBirth": "1978-11-21",
        "experimentsCount": 0,
        "modifiedDatetime": "2019-07-01T11:49:50.332+07:00",
        "sex": "U",
        "state": "",
        "subjectName": "Bob Smith"
    }
}
```
{% endtab %}
{% endtabs %}
