# updateHeadsetCustomInfo

This method lets you set the headband position of an EPOC X headset.

The headband position is important to interpret the motion data coming from the headset. The motion sensor is located in the headband. So Cortex uses the headband position to know the orientation of the motion sensor.

When you [start a record](https://emotiv.gitbook.io/cortex-api/records/createrecord) Cortex saves the current headband position into the record. So you should set the  position before starting the record.

*This method was added in Cortex 2.4*

## Parameters

| Name             | Type     | Required | Description                                                                                           |
| ---------------- | -------- | -------- | ----------------------------------------------------------------------------------------------------- |
| cortexToken      | `string` | yes      | A token returned by [authorize](https://emotiv.gitbook.io/cortex-api/authentication/authorize).       |
| headsetId        | `string` | yes      | A headset id returned by [queryHeadsets](https://emotiv.gitbook.io/cortex-api/headset/queryheadsets). |
| headbandPosition | `string` | yes      | Must be "back" or "top".                                                                              |

## Result

The result is an object containing these fields:

| Name             | Type     | Description                                           |
| ---------------- | -------- | ----------------------------------------------------- |
| headsetId        | `string` | The headset id used in the request.                   |
| customName       | `string` | The custom name of the headset.                       |
| headbandPosition | `string` | The position of the headband. Can be "back" or "top". |

## Examples

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

```javascript
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "updateHeadsetCustomInfo",
  "params": {
    "cortexToken": "xxx",
    "headbandPosition": "top",
    "headsetId": "EPOCX-12345678"
  }
}
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "customName": "Epoc 1",
    "headbandPosition": "top",
    "headsetId": "EPOCX-12345678",
    "message": "Update headset customized information successfully."
  }
}
```

{% 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://emotiv.gitbook.io/cortex-api/headset/updateheadsetcustominfo.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.