# Records

After you opened a [session](/cortex-api/session.md) with a headset, you can create a record. A record is a permanent object to store data from an EMOTIV headset. You can associate a [subject](/cortex-api/subjects.md) to a record. You can add one or more [markers](/cortex-api/markers.md) to a record.

Unlike a [session](/cortex-api/session.md), a record is a permanent object. It is stored on the hard drive and then can be synchronized to the EMOTIV cloud. The [opt-out](/cortex-api/records/configoptout.md) configuration can let you decide if the records of a user are uploaded to the cloud or not.

## Record lifetime

First, you must [open a session](/cortex-api/session/createsession.md) with a headset. Then you call [createRecord](/cortex-api/records/createrecord.md) to start a new record. When the record is in progress, you can add [markers](/cortex-api/markers.md) to this record. You stop a record with [updateRecord](/cortex-api/records/updaterecord.md).

The record is linked to the session, so if you close the session, or if your application is disconnected from the Cortex service, then Cortex will automatically close the record.

After you stop the record you can export its data to a CSV or EDF file using [exportRecord](/cortex-api/records/exportrecord.md).


---

# 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/records.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.
