Recording a Session

Overview

Airtop automatically records all browser sessions by default. Each window in a session creates a separate recording file, allowing you to review exactly what happened during your automation. This is incredibly useful for debugging, auditing, and understanding how your automation performed.

How recordings work

When you create a session, Airtop automatically starts recording all browser activity. The recording captures:

• All page interactions (clicks, typing, scrolling)
• Page navigation and loading
• Visual changes on the page
• Each window as a separate recording file

Recordings are stored securely and can be accessed through the Airtop portal or programmatically via the API.

Viewing recordings

Through the Airtop Portal

The easiest way to view recordings is through the Airtop portal. Navigate to the browser sessions page and click on any session to view its details. From there, you can:

• Watch recordings in real-time
• Download recording files
• Review session metadata and logs

Programmatically via API

You can also access recordings programmatically using the files API. Here’s how to list and download recordings for a specific session:

1
// List all files for a session
2
const files = await client.files.list({
3
    sessionIds: [sessionId],
4
});
5
6
// Filter for video recordings
7
const recordings = files.data.files?.filter(file => file.fileType === "video");
8
console.log('Recording count:', recordings?.length);
9
10
// Download each recording
11
recordings?.forEach(async (file) => {
12
    console.log('File:', file.fileName, file.fileType, file.fileBytes);
13
    await client.files.download(file.id, `./${file.fileName}`);
14
});

Disabling recordings

If you don’t want to record a session (for example, for privacy reasons), you can disable recording using the disableRecording configuration parameter:

1
const client = new AirtopClient({apiKey: "YOUR_API_KEY"});
2
const session = await client.sessions.create({
3
    configuration: {
4
        disableRecording: true,
5
    }
6
});

Recording considerations

Storage and retention

• Recordings are stored securely in Airtop’s infrastructure
• Recording files are automatically cleaned up after 7 days
• You can download recordings at any time before they’re cleaned up

File formats

Recordings are saved in MP4 format and can be played in any standard video player. Each recording file contains:

• High-quality video capture of the browser window using H.264 video codec
• Accurate timing of all interactions