> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corti.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# startRecording()

> Reference for the Embedded API startRecording() method.

Use `startRecording()` to begin recording within the current embedded session.

<Info>
  Applies to Web Component, Window API, and PostMessage. Examples on this page
  use the Web Component API shape.
</Info>

## Usage

```typescript theme={null}
await api.startRecording();
```

## Prerequisites

* User must be authenticated.
* An interaction must exist.
* The application must be in an interview or session context.

## Input validation

* None

## Possible errors

* `NOT_READY`: Not in interview context or no interaction exists.
* `UNAUTHORIZED`: User not authenticated.
* `NOT_FOUND`: Interaction not found.
* `INTERNAL_ERROR`: Failed to connect to the recording service.

## Returns

`void`

## Related reference

* [API Reference Overview](/assistant/api-reference)
* [createInteraction()](/assistant/api/create-interaction)
* [stopRecording()](/assistant/api/stop-recording)