Changes from V1.x to V2.0

There are significant changes from Cortex API version 1.x to 2.0.

WebSocket URL

To connect to Cortex 1.x, you used the url wss:// In Cortex 2.0, you must use wss://localhost:6868

See Connecting to the Cortex API for details.


In Cortex 2.0, the user must login with his/her EmotivID though the EMOTIV App. So the API doesn't have a login or logout method anymore.

Third party applications must be approved by the user before they can use the Cortex API. See the new method requestAccess.

The method authorize doesn't accept "anonymous mode" anymore. You must provide a client id and client secret.

See Authentication for details.


You need to call the method controlDevice to connect a headset to Cortex. If the headset is not connected, then you can't create a session with this headset.

See Headsets for details.


Some methods have been removed or renamed.

Method name in v1

Equivalent in v2

login, logout

See getUserLogin.


The user must accept the EULA in EMOTIV App. You can call getUserInformation to check if the user already accepted the EULA or not.


See controlDevice.


See updateRecord.

The parameters and result format of some methods have changed. If you get an error when calling a method, please check its documentation.