### POST /launch

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Starts the browser session for a specific profile.

```APIDOC
## POST /launch

### Description
Starts the browser with the specified profile ID and returns a WebSocket URL for integration with puppeteer.

### Method
POST

### Endpoint
/launch

### Parameters
#### Request Body
- **profileId** (string) - Required - The ID of the profile to launch.

### Response
#### Success Response (200)
- **wsUrl** (string) - The WebSocket URL for browser control.
```

--------------------------------

### Launch Browser Profile

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Starts the browser instance associated with the provided profile ID. Returns a WebSocket URL used for connecting automation tools like Puppeteer.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
await GL.launch({ profileId: 'some profileId' })
```

--------------------------------

### Initialize GoLogin and Launch Profile

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Demonstrates how to initialize the GoLogin API, create a profile with a random fingerprint, assign a proxy, and launch the browser for automation.

```javascript
import { GologinApi } from './src/gologin-api.js';

const GL = GologinApi({
  token: 'your token',
});

const profile = await GL.createProfileRandomFingerprint('some name');
const profileId = profile.id;

await GL.addGologinProxyToProfile(profileId, 'us');
const browser = await GL.launch({ profileId });
const page = await browser.newPage();
await page.goto('https://linkedin.com');
await new Promise((resolve) => setTimeout(resolve, 5000));
await browser.close();
await GL.stop();
```

--------------------------------

### Configure GoLogin Instance

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Shows how to instantiate the GoLogin class with specific configuration options such as profile ID and extra browser parameters.

```javascript
const GL = new GoLogin({
    token: 'your token',
    profile_id: 'profile id',
    extra_params: ["--headless", "--load-extentions=path/to/extension"]
});
```

--------------------------------

### Initialize GoLogin SDK

Source: https://context7.com/gologinapp/gologin/llms.txt

Demonstrates how to instantiate the GologinApi client using an API token. This is the required first step for all subsequent profile management and browser automation tasks.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({
  token: 'your-api-token-here'
});
```

--------------------------------

### Complete Automation with GoLogin SDK

Source: https://context7.com/gologinapp/gologin/llms.txt

This script demonstrates a full automation cycle: creating a new browser profile with a random fingerprint, configuring a proxy, adding authentication cookies, launching a browser, navigating to a target site, extracting data using Puppeteer, and finally cleaning up by deleting the profile and exiting the GoLogin instance. It handles potential errors and ensures cleanup in a finally block.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: process.env.GL_API_TOKEN });

async function scrapeWithNewProfile() {
  let profileId = null;

  try {
    // Create new profile with random fingerprint
    const profile = await gologin.createProfileRandomFingerprint('Scraping Profile');
    profileId = profile.id;
    console.log('Created profile:', profileId);

    // Add US proxy
    await gologin.addGologinProxyToProfile(profileId, 'us');
    console.log('Proxy configured');

    // Add authentication cookies
    await gologin.addCookiesToProfile(profileId, [
      {
        name: 'auth',
        value: 'logged_in_token',
        domain: '.targetsite.com',
        path: '/',
        secure: true,
        httpOnly: true
      }
    ]);

    // Launch browser
    const { browser } = await gologin.launch({ profileId });
    const page = await browser.newPage();

    // Set viewport to match profile resolution
    await page.setViewport({ width: 1920, height: 1080 });

    // Navigate and extract data
    await page.goto('https://targetsite.com/data', {
      waitUntil: 'networkidle2',
      timeout: 30000
    });

    const data = await page.evaluate(() => {
      const items = document.querySelectorAll('.data-item');
      return Array.from(items).map(item => ({
        title: item.querySelector('.title')?.textContent,
        value: item.querySelector('.value')?.textContent
      }));
    });

    console.log('Extracted data:', data);

    await browser.close();
    return data;

  } catch (error) {
    console.error('Automation failed:', error);
    throw error;
  } finally {
    // Clean up: delete profile and exit
    if (profileId) {
      await gologin.deleteProfile(profileId);
    }
    await gologin.exit();
  }
}

scrapeWithNewProfile()
  .then(data => console.log('Success:', data.length, 'items'))
  .catch(error => process.exit(1));

```

--------------------------------

### Launch Browser Profile with Puppeteer

Source: https://context7.com/gologinapp/gologin/llms.txt

Shows how to launch a browser profile locally or in the cloud using the GologinApi. It covers headless mode, profile selection, and basic Puppeteer interaction.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

const { browser } = await gologin.launch({
  profileId: 'existing-profile-id'
});

const page = await browser.newPage();
await page.goto('https://example.com', { waitUntil: 'networkidle2' });
await browser.close();
await gologin.exit();
```

--------------------------------

### Configure Advanced GoLogin Class

Source: https://context7.com/gologinapp/gologin/llms.txt

Provides low-level control over browser profiles, including custom paths, browser flags, and cloud synchronization settings.

```javascript
import GoLogin from 'gologin';

const gl = new GoLogin({
  token: 'your-api-token',
  profile_id: 'profile-id',
  executablePath: '/path/to/orbita/browser',
  tmpdir: '/custom/temp/directory',
  extra_params: ['--disable-gpu'],
  uploadCookiesToServer: true,
  writeCookiesFromServer: true,
  autoUpdateBrowser: true,
  remote_debugging_port: 9222,
  vncPort: 5900
});

// Start the browser
const { wsUrl, resolution } = await gl.start();
console.log('WebSocket URL:', wsUrl);
console.log('Resolution:', resolution);

// Connect with Puppeteer
import puppeteer from 'puppeteer-core';
const browser = await puppeteer.connect({
  browserWSEndpoint: wsUrl,
  ignoreHTTPSErrors: true
});

const page = await browser.newPage();
await page.goto('https://example.com');

// Stop and commit changes
await browser.close();
await gl.stop();
```

--------------------------------

### Create Profile with Custom Parameters

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Creates a new browser profile with specific custom parameters, including navigator settings like user agent and resolution.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
const profile = await gl.createProfileWithCustomParams({
    "os": "lin",
    "name": "some name",
    "navigator": {
        "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36",
        "resolution": "1920x1080",
        "language": "en-US",
        "platform": "Linux x86_64",
        "hardwareConcurrency": 8,
        "deviceMemory": 8,
        "maxTouchPoints": 0
    }
})
const profileId = profile.id
```

--------------------------------

### Delete Profile with GoLogin API

Source: https://context7.com/gologinapp/gologin/llms.txt

Demonstrates how to create a temporary profile, perform browser automation, and permanently delete the profile to clean up account resources.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Create a temporary profile for one-time use
const profile = await gologin.createProfileRandomFingerprint('Temporary Profile');
const profileId = profile.id;

// Use the profile
const { browser } = await gologin.launch({ profileId });
const page = await browser.newPage();
await page.goto('https://example.com');
await page.screenshot({ path: 'screenshot.png' });
await browser.close();

// Delete when done
await gologin.deleteProfile(profileId);
console.log('Profile deleted');

await gologin.exit();
```

--------------------------------

### Create Profile with Custom Fingerprint Parameters

Source: https://context7.com/gologinapp/gologin/llms.txt

Configures a browser profile with specific fingerprint settings, including custom user agents, proxy configurations, WebGL metadata, and geolocation data.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

const profileId = await gologin.createProfileWithCustomParams({
  os: 'win',
  name: 'Custom Windows Profile',
  navigator: {
    userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36',
    resolution: '1920x1080'
  },
  proxy: {
    mode: 'http',
    host: 'proxy.example.com',
    port: 8080
  }
});
```

--------------------------------

### Add GoLogin Proxy to Profile

Source: https://context7.com/gologinapp/gologin/llms.txt

Adds a GoLogin-provided proxy to an existing profile. Supports residential, mobile, and datacenter proxy types. Requires an active GoLogin subscription with available traffic. Automatically selects proxy type if not specified.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

const profile = await gologin.createProfileRandomFingerprint('Proxy Profile');
const profileId = profile.id;

// Auto-select available proxy type based on traffic
const proxy = await gologin.addGologinProxyToProfile(profileId, 'us');
console.log('Traffic used:', proxy.trafficUsedBytes);
console.log('Traffic limit:', proxy.trafficLimitBytes);

// Specify proxy type explicitly
await gologin.addGologinProxyToProfile(profileId, 'uk', 'resident');  // Residential proxy
await gologin.addGologinProxyToProfile(profileId, 'de', 'mobile');    // Mobile proxy
await gologin.addGologinProxyToProfile(profileId, 'fr', 'dataCenter'); // Datacenter proxy

// Launch profile with the configured proxy
const { browser } = await gologin.launch({ profileId });
const page = await browser.newPage();
await page.goto('https://whatismyipaddress.com');
await gologin.exit();
```

--------------------------------

### Add GoLogin Proxy to Profile

Source: https://context7.com/gologinapp/gologin/llms.txt

Adds a GoLogin-provided proxy to an existing profile. Supports residential, mobile, and datacenter proxy types. Requires an active GoLogin subscription with available traffic.

```APIDOC
## addGologinProxyToProfile - Add GoLogin Proxy

### Description
Adds a GoLogin-provided proxy to an existing profile. Supports residential, mobile, and datacenter proxy types. Requires an active GoLogin subscription with available traffic.

### Method
POST (Assumed, based on action)

### Endpoint
`/profiles/{profileId}/gologin-proxy` (Assumed, based on action)

### Parameters
#### Path Parameters
- **profileId** (string) - Required - The ID of the profile to add the proxy to.

#### Query Parameters
- **countryCode** (string) - Required - The country code for the proxy (e.g., 'us', 'uk', 'de').
- **proxyType** (string) - Optional - The type of proxy to use ('resident', 'mobile', 'dataCenter'). If not specified, GoLogin will auto-select based on available traffic.

### Request Example
```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

const profile = await gologin.createProfileRandomFingerprint('Proxy Profile');
const profileId = profile.id;

// Auto-select available proxy type based on traffic
const proxy = await gologin.addGologinProxyToProfile(profileId, 'us');
console.log('Traffic used:', proxy.trafficUsedBytes);
console.log('Traffic limit:', proxy.trafficLimitBytes);

// Specify proxy type explicitly
await gologin.addGologinProxyToProfile(profileId, 'uk', 'resident');  // Residential proxy
await gologin.addGologinProxyToProfile(profileId, 'de', 'mobile');    // Mobile proxy
await gologin.addGologinProxyToProfile(profileId, 'fr', 'dataCenter'); // Datacenter proxy
```

### Response
#### Success Response (200)
- **trafficUsedBytes** (number) - The amount of traffic used after adding the proxy.
- **trafficLimitBytes** (number) - The total traffic limit for the proxy.

#### Response Example
```json
{
  "trafficUsedBytes": 102400,
  "trafficLimitBytes": 104857600
}
```
```

--------------------------------

### POST /exit

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Stops the browser session and synchronizes data.

```APIDOC
## POST /exit

### Description
Stops the running browser instance and uploads profile data to the storage.

### Method
POST

### Endpoint
/exit

### Response
#### Success Response (200)
- **status** (string) - Confirmation that the browser has exited and data is saved.
```

--------------------------------

### POST /browser/{profileId}/web

Source: https://context7.com/gologinapp/gologin/llms.txt

Stops a running cloud browser instance and commits changes.

```APIDOC
## DELETE /browser/{profileId}/web

### Description
Terminates the cloud-hosted browser session for the specified profile.

### Method
DELETE

### Endpoint
/browser/{profileId}/web

### Parameters
#### Path Parameters
- **profileId** (string) - Required - The unique identifier of the profile.

### Request Example
fetch('https://api.gologin.com/browser/profile-id/web', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer your-api-token' }
});

### Response
#### Success Response (200)
- **result** (string) - Success confirmation.
```

--------------------------------

### Import Cookies to Profile

Source: https://context7.com/gologinapp/gologin/llms.txt

Adds cookies to a browser profile before launching. Useful for maintaining login sessions or importing cookies from other sources.

```APIDOC
## addCookiesToProfile - Import Cookies

### Description
Adds cookies to a browser profile before launching. Useful for maintaining login sessions or importing cookies from other sources.

### Method
POST (Assumed, based on action)

### Endpoint
`/profiles/{profileId}/cookies` (Assumed, based on action)

### Parameters
#### Path Parameters
- **profileId** (string) - Required - The ID of the profile to add cookies to.

#### Request Body
- **cookies** (array) - Required - An array of cookie objects.
  - **name** (string) - Required - The name of the cookie.
  - **value** (string) - Required - The value of the cookie.
  - **domain** (string) - Required - The domain the cookie is associated with.
  - **path** (string) - Optional - The path the cookie is associated with. Defaults to '/'.
  - **expirationDate** (number) - Optional - The expiration date of the cookie in Unix timestamp format.
  - **httpOnly** (boolean) - Optional - Whether the cookie is HTTP only.
  - **secure** (boolean) - Optional - Whether the cookie is secure.
  - **sameSite** (string) - Optional - The SameSite attribute of the cookie ('Strict', 'Lax', 'None').

### Request Example
```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

await gologin.addCookiesToProfile('profile-id', [
  {
    name: 'session_id',
    value: 'abc123xyz789',
    domain: '.example.com',
    path: '/',
    expirationDate: Math.floor(Date.now() / 1000) + 86400 * 30, // 30 days
    httpOnly: true,
    secure: true,
    sameSite: 'lax'
  },
  {
    name: 'user_preferences',
    value: 'theme=dark&lang=en',
    domain: 'example.com',
    path: '/settings',
    secure: false,
    httpOnly: false
  },
  {
    name: 'auth_token',
    value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
    domain: '.api.example.com',
    path: '/',
    expirationDate: Math.floor(Date.now() / 1000) + 3600,
    httpOnly: true,
    secure: true,
    sameSite: 'strict'
  }
]);
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating cookies were added.

#### Response Example
```json
{
  "message": "Cookies added successfully."
}
```
```

--------------------------------

### Clean Up Resources with Exit

Source: https://context7.com/gologinapp/gologin/llms.txt

Ensures that all browser processes are terminated and temporary files are cleaned up after automation tasks are completed.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

async function runAutomation() {
  const { browser } = await gologin.launch({ profileId: 'profile-id' });

  try {
    const page = await browser.newPage();
    await page.goto('https://example.com');
    // ... automation logic
  } finally {
    // Always call exit to clean up
    await gologin.exit();
  }
}

runAutomation().catch(console.error);
```

--------------------------------

### Create Profile with Random Fingerprint

Source: https://context7.com/gologinapp/gologin/llms.txt

Creates a new browser profile with an automatically generated fingerprint based on the host operating system. Useful for quickly generating unique browser identities.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

const profile = await gologin.createProfileRandomFingerprint('My Automation Profile');
console.log('New profile ID:', profile.id);
```

--------------------------------

### Set Custom Proxy for Profile

Source: https://context7.com/gologinapp/gologin/llms.txt

Updates the proxy configuration for an existing profile. Supports HTTP, HTTPS, SOCKS4, SOCKS5, and no proxy modes.

```APIDOC
## changeProfileProxy - Set Custom Proxy

### Description
Updates the proxy configuration for an existing profile. Supports HTTP, HTTPS, SOCKS4, SOCKS5, and no proxy modes.

### Method
PUT (Assumed, based on action)

### Endpoint
`/profiles/{profileId}/proxy` (Assumed, based on action)

### Parameters
#### Path Parameters
- **profileId** (string) - Required - The ID of the profile to update.

#### Request Body
- **mode** (string) - Required - The proxy mode ('http', 'https', 'socks4', 'socks5', 'none').
- **host** (string) - Required (if mode is not 'none') - The proxy server hostname or IP address.
- **port** (number) - Required (if mode is not 'none') - The proxy server port.
- **username** (string) - Optional - The username for proxy authentication.
- **password** (string) - Optional - The password for proxy authentication.

### Request Example
```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Set HTTP proxy with authentication
await gologin.changeProfileProxy('profile-id', {
  mode: 'http',
  host: 'proxy.example.com',
  port: 8080,
  username: 'user',
  password: 'pass'
});

// Set SOCKS5 proxy
await gologin.changeProfileProxy('profile-id', {
  mode: 'socks5',
  host: '192.168.1.100',
  port: 1080,
  username: 'socksuser',
  password: 'sockspass'
});

// Remove proxy
await gologin.changeProfileProxy('profile-id', {
  mode: 'none',
  host: '',
  port: 0
});
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating the proxy was updated.

#### Response Example
```json
{
  "message": "Proxy updated successfully."
}
```
```

--------------------------------

### Add Cookies to Profile

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Imports a list of cookie objects into a specific profile, which the browser will load upon startup.

```javascript
const GL = GoLogin({
	"token": "your token",
	})

await GL.addCookiesToProfile("profileId", [
    {
        "name": "session_id",
        "value": "abc123",
        "domain": "example.com",
        "path": "/",
        "expirationDate": 1719161018.307793,
        "httpOnly": true,
        "secure": true
    },
    {
        "name": "user_preferences",
        "value": "dark_mode",
        "domain": "example.com",
        "path": "/settings",
        "sameSite": "lax"
    }
])
```

--------------------------------

### Integrate Cloud Browsers via WebSocket

Source: https://context7.com/gologinapp/gologin/llms.txt

Connects Puppeteer directly to a cloud-hosted GoLogin browser instance, allowing for remote automation without local browser management.

```javascript
import puppeteer from 'puppeteer-core';

const token = 'your-api-token';
const profileId = 'profile-id';

const CLOUD_BROWSER_URL = `https://cloudbrowser.gologin.com/connect?token=${token}&profile=${profileId}`;

async function runCloudBrowser() {
  // Verify cloud browser is available
  const response = await fetch(CLOUD_BROWSER_URL);
  if (!response.ok) {
    const errorReason = response.headers.get('X-Error-Reason');
    throw new Error(`Cloud browser failed: ${errorReason ?? response.statusText}`);
  }

  // Connect Puppeteer to cloud browser
  const browser = await puppeteer.connect({
    browserWSEndpoint: CLOUD_BROWSER_URL,
    ignoreHTTPSErrors: true
  });

  const page = await browser.newPage();
  await page.goto('https://example.com');
  const screenshot = await page.screenshot({ encoding: 'base64' });

  await browser.close();

  // Stop the cloud profile
  await fetch(`https://api.gologin.com/browser/${profileId}/web`, {
    method: 'DELETE',
    headers: { Authorization: `Bearer ${token}` }
  });

  return screenshot;
}

runCloudBrowser().catch(console.error);
```

--------------------------------

### Configure Profile Proxy

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Sets proxy settings for a specific browser profile. It accepts a profile ID and a configuration object containing mode, host, port, and authentication credentials.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
await GL.changeProfileProxy("profileId", { "mode": "http", "host": "somehost.com", "port": 109, "username": "someusername", "password": "somepassword"})
```

--------------------------------

### Change Profile Proxy Configuration

Source: https://context7.com/gologinapp/gologin/llms.txt

Updates the proxy configuration for an existing profile. Supports HTTP, HTTPS, SOCKS4, SOCKS5, and no proxy modes. Allows setting custom proxy details including authentication.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Set HTTP proxy with authentication
await gologin.changeProfileProxy('profile-id', {
  mode: 'http',
  host: 'proxy.example.com',
  port: 8080,
  username: 'user',
  password: 'pass'
});

// Set SOCKS5 proxy
await gologin.changeProfileProxy('profile-id', {
  mode: 'socks5',
  host: '192.168.1.100',
  port: 1080,
  username: 'socksuser',
  password: 'sockspass'
});

// Remove proxy
await gologin.changeProfileProxy('profile-id', {
  mode: 'none',
  host: '',
  port: 0
});
```

--------------------------------

### Add Cookies to Profile

Source: https://context7.com/gologinapp/gologin/llms.txt

Adds cookies to a browser profile before launching. This is useful for maintaining login sessions or importing cookies from other sources. Cookies can be configured with domain, path, and expiration details.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

await gologin.addCookiesToProfile('profile-id', [
  {
    name: 'session_id',
    value: 'abc123xyz789',
    domain: '.example.com',
    path: '/',
    expirationDate: Math.floor(Date.now() / 1000) + 86400 * 30, // 30 days
    httpOnly: true,
    secure: true,
    sameSite: 'lax'
  },
  {
    name: 'user_preferences',
    value: 'theme=dark&lang=en',
    domain: 'example.com',
    path: '/settings',
    secure: false,
    httpOnly: false
  },
  {
    name: 'auth_token',
    value: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',
    domain: '.api.example.com',
    path: '/',
    expirationDate: Math.floor(Date.now() / 1000) + 3600,
    httpOnly: true,
    secure: true,
    sameSite: 'strict'
  }
]);

// Launch and verify cookies are set
const { browser } = await gologin.launch({ profileId: 'profile-id' });
const page = await browser.newPage();
await page.goto('https://example.com');
const cookies = await page.cookies();
console.log('Current cookies:', cookies);
await gologin.exit();
```

--------------------------------

### POST /changeProfileProxy

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Updates the proxy settings for a specific browser profile.

```APIDOC
## POST /changeProfileProxy

### Description
Allows you to set or update a proxy configuration for a specific profile.

### Method
POST

### Endpoint
/changeProfileProxy

### Parameters
#### Request Body
- **profileId** (string) - Required - The ID of the profile.
- **proxy** (object) - Required - Proxy configuration object containing mode, host, port, username, and password.

### Request Example
{
  "mode": "http",
  "host": "somehost.com",
  "port": 109,
  "username": "user",
  "password": "pass"
}
```

--------------------------------

### Refresh Profile Fingerprints

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Updates the browser fingerprint for specified profiles. This requires a valid GoLogin token and a list of profile IDs.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
await GL.refreshProfilesFingerprint(["profileId1", "profileId2"])
```

--------------------------------

### Update Profile User Agents to Latest

Source: https://context7.com/gologinapp/gologin/llms.txt

Updates the user agent string for profiles to match the latest browser version. This helps keep profiles current and reduces the risk of detection. Can target single or multiple profiles, optionally within a specific workspace.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Update single profile
await gologin.updateUserAgentToLatestBrowser(['profile-id']);

// Update multiple profiles
await gologin.updateUserAgentToLatestBrowser([
  'profile-id-1',
  'profile-id-2'
]);

// Update profiles in a specific workspace
await gologin.updateUserAgentToLatestBrowser(
  ['profile-id-1', 'profile-id-2'],
  'workspace-id'
);
```

--------------------------------

### Exit Browser Session

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Terminates the active browser session and triggers the upload of profile data to cloud storage. This should be called after automation tasks are completed.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
await GL.launch({ profileId: 'some profileId' })
await GL.exit()
```

--------------------------------

### Update User Agents to Latest Browser

Source: https://context7.com/gologinapp/gologin/llms.txt

Updates the user agent string for profiles to match the latest browser version. Keeps profiles current and reduces detection risk.

```APIDOC
## updateUserAgentToLatestBrowser - Update User Agents

### Description
Updates the user agent string for profiles to match the latest browser version. Keeps profiles current and reduces detection risk.

### Method
PUT (Assumed, based on action)

### Endpoint
`/profiles/user-agents/latest` (Assumed, based on action)

### Parameters
#### Request Body
- **profileIds** (array) - Required - An array of profile IDs to update.
- **workspaceId** (string) - Optional - The ID of the workspace to which the profiles belong.

### Request Example
```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Update single profile
await gologin.updateUserAgentToLatestBrowser(['profile-id']);

// Update multiple profiles
await gologin.updateUserAgentToLatestBrowser([
  'profile-id-1',
  'profile-id-2'
]);

// Update profiles in a specific workspace
await gologin.updateUserAgentToLatestBrowser(
  ['profile-id-1', 'profile-id-2'],
  'workspace-id'
);
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating user agents were updated.

#### Response Example
```json
{
  "message": "User agents updated successfully."
}
```
```

--------------------------------

### POST /refreshProfilesFingerprint

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Replaces the fingerprint of specified browser profiles with new ones.

```APIDOC
## POST /refreshProfilesFingerprint

### Description
Replaces your profile fingerprint with a new one for the provided profile IDs.

### Method
POST

### Endpoint
/refreshProfilesFingerprint

### Parameters
#### Request Body
- **profileIds** (array) - Required - List of profile IDs to update.

### Request Example
["profileId1", "profileId2"]

### Response
#### Success Response (200)
- **status** (string) - Confirmation of fingerprint update.
```

--------------------------------

### Update Profile Fingerprints

Source: https://context7.com/gologinapp/gologin/llms.txt

Replaces fingerprints for one or more profiles with new randomly generated ones. Useful for rotating identities while keeping other profile settings.

```APIDOC
## refreshProfilesFingerprint - Update Profile Fingerprints

### Description
Replaces fingerprints for one or more profiles with new randomly generated ones. Useful for rotating identities while keeping other profile settings.

### Method
PUT (Assumed, based on action)

### Endpoint
`/profiles/fingerprints/refresh` (Assumed, based on action)

### Parameters
#### Request Body
- **profileIds** (array) - Required - An array of profile IDs to refresh.
- **workspaceId** (string) - Optional - The ID of the workspace to which the profiles belong.

### Request Example
```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Refresh single profile
await gologin.refreshProfilesFingerprint(['profile-id-1']);

// Refresh multiple profiles at once
await gologin.refreshProfilesFingerprint([
  'profile-id-1',
  'profile-id-2',
  'profile-id-3'
]);

// Refresh profiles in a specific workspace
await gologin.refreshProfilesFingerprint(
  ['profile-id-1', 'profile-id-2'],
  'workspace-id'
);
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation message indicating fingerprints were refreshed.

#### Response Example
```json
{
  "message": "Profile fingerprints refreshed successfully."
}
```
```

--------------------------------

### Refresh Profile Fingerprints

Source: https://context7.com/gologinapp/gologin/llms.txt

Replaces fingerprints for one or more profiles with new randomly generated ones. This is useful for rotating identities while keeping other profile settings intact. Can be applied to single or multiple profiles.

```javascript
import { GologinApi } from 'gologin';

const gologin = GologinApi({ token: 'your-api-token' });

// Refresh single profile
await gologin.refreshProfilesFingerprint(['profile-id-1']);

// Refresh multiple profiles at once
await gologin.refreshProfilesFingerprint([
  'profile-id-1',
  'profile-id-2',
  'profile-id-3'
]);

console.log('Fingerprints refreshed successfully');
```

--------------------------------

### Update User Agent for Profiles

Source: https://github.com/gologinapp/gologin/blob/master/README.md

Updates the user agent of specified profiles to the latest browser version to maintain fingerprint integrity.

```javascript
const GL = GoLogin({
	"token": "your token",
	})
await GL.updateUserAgentToLatestBrowser(["profineId1", "profileId2"], "workspceId(optional)")
```

--------------------------------

### DELETE /profile/{profileId}

Source: https://context7.com/gologinapp/gologin/llms.txt

Permanently deletes a browser profile from your account. This action cannot be undone.

```APIDOC
## DELETE /profile/{profileId}

### Description
Permanently removes a browser profile and all associated data from the GoLogin account.

### Method
DELETE

### Endpoint
/profile/{profileId}

### Parameters
#### Path Parameters
- **profileId** (string) - Required - The unique identifier of the profile to be deleted.

### Request Example
await gologin.deleteProfile('profile-id-123');

### Response
#### Success Response (200)
- **status** (string) - Confirmation message of deletion.
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.