# User Fingerprints

Browser fingerprints are unique identifiers that help ensure consistency across sessions. By creating a fingerprint, you can retain session cookies, browsing history, proxy IP, and other configuration settings between user sessions. This ensures that when users return, their experience is the same, with their preferences, settings, and data preserved for persistence.

### Personalized Experience

Customizing various aspects of the fingerprint—such as screen resolution, DPI, device configurations, and proxy settings—helps maintain a consistent and personalized browsing experience, making it easier to track and manage user sessions over time. This configuration will continue to expand, allowing for even more detailed and accurate session management in the future.

#### Screen Resolution

Adjust the resolution of the browser window. Available options:

* `"1280x1024"`, `"1920x1080"`, `"1366x768"`, `"1536x864"`, `"1280x720"`, `"1440x900"`, or `"1280x2400"`

#### Color Depth

Set the color depth of the screen. Possible values:

* `24`, `30`, or `32`

#### DPI

Define the DPI for screen scaling. Supported values:

* `96`, `120`, `144`, or `192`

### Example Request Body

```json
{
  "screen": {
    "resolution": "1280x2400",
    "depth": 24,
    "dpi": 96
  },
  "device": {
    "numSpeakers": 2,
    "numMicrophones": 2,
    "numCameras": 1
  },
  "proxy": {
    "country": "US"
  },
  "extensions": []
}
```

### Example Response Body

{% hint style="warning" %}
store the **fingerprintSecret**. It cannot be retrieved once lost.
{% endhint %}

```json
{
    "fingerprintUUID": "36a33f12-75ef-40f3-90de-31e9225a2f4f",
    "fingerprintSecret": "dY5znu6P1DOW06jUkqHWDLhq1ERNSS6xYKSRdnZjBpYG0SiE/XzfhCKCiLUL52alIwT8TrgiCrQGxUFY6pJ5AHSmdRh9EiQI9HnJaDMalKoo8hHhJOdOx00zDoLlFxuEEHH0Q43dBJzCQxrBAuv4pcQjWI1wBR8W1STgMXliRYKtfO0S94B0ItKvn3p60pAkVTvqkmMDPyOD8Fb5Tnhb2L1exdNpJWPBd79+GB+bhHirPXfnT8lkvIfDvpmf7vi79RuhXLgmn/ivutvKbNlZs6xq6u9F8hW3Ee33Yxo/0gdjiEV7pN4DLXb0UzuXAOKrpLOZcxvROKG10nvspaj06SPT7tasYTK8+pNsrCIYlFMzrAZhRL0d2L9JeMV5g1uR7Ih5N88/ZDI06mT2gcVVVFOoeiIJN2eLQkAODoSsI0k2DO0DxSBktCzpHHf6QP8Y+71LS859s5Gg1no4/NSfEu1HEPy/dmi0TqoytQ5bxGfe0AC8Ii/EoqgncmfTNXxm6LK9wOQoAoQEXWh/Dx4NgX60EXomwwLGiwZW7zuF/YsOoJEyHjjccQCu1QQ4ZGnn3gBeHWBoi/MtUqos9pUm1KpSJBq3WFE2QXvCJ28pbOzs//UEde9CKv8JhBlirr6yX8tXsC4qwiVUcv1u+SBa7d3q8nOQdNoAZsdaBSfL/yo=",
    "isArchived": false,
    "browserConfig": {
        "browser": "chromium",
        "extensions": [],
        "numCameras": 1,
        "numMicrophones": 2,
        "numSpeakers": 2,
        "screenDPI": 96,
        "screenDepth": 24,
        "screenResolution": "1280x2400",
        "userAgent": ""
    },
    "proxy": {
        "country": "US",
        "type": "notAssigned"
    },
    "createdAt": "2025-01-27T00:35:07.184793339Z",
    "updatedAt": "2025-01-27T00:35:07.184793339Z"
}
```

The `fingerprintSecret` is a unique encryption key associated with the user's fingerprint, and it plays a crucial role in securing session data. This secret will be used to decrypt any session-related information, such as cookies, history, or other sensitive data. By encrypting session data with the fingerprint secret, cookies and other data are stored securely, ensuring that they can only be accessed or modified using the same secret. 

{% content-ref url="/pages/BofI0KDi793ELF7FrgeO" %}
[Fingerprints](/reference/api-reference/fingerprints.md)
{% endcontent-ref %}


---

# 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://dev-docs.tasknet.co/features/user-fingerprints.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.