API Endpoints
Profiles
Edit profile

Base URL

PATCH
https://v1.empr.cloud/api/v1/folders/{folderId}/profiles/{profileId}

Request

Request Headers

Headers
Название
Тип / Значение
Описание
X-Token
String
Authorization token
Content-Type
application/json

URL Parameters

Request Parameters
Название
Тип / Значение
Описание
folderId
UUID
Folder ID
profileId
UUID
Profile ID

Request Body

Request Body
Название
Тип / Значение
Описание
profile_name
String?
Profile name
profile_notes
String?
Profile notes
profile_tags
UUID[]?
Profile tags
new_profile_tags
String[]?
Tags to create and add to the profile
profile_status
UUID?
Profile status
pinned
Boolean?
Profile pinned status
proxy_id
"none" | Proxy
Proxy

Proxy
Название
Тип / Значение
Описание
id
UUID
Proxy ID

At least one of the parameters must be specified

Request Examples

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/profiles/{profileId}"; 
3
4const body = {
5  "profile_name": "New profile name",
6  "new_profile_tags": [
7    "New tag"
8  ]
9}
10
11const options = {
12  method: "PATCH",
13  headers: {
14    "X-Token": "Your Token", 
15    "Content-Type": "application/json"
16  }, 
17  body: JSON.stringify(body)
18};
19
20fetch(url, options)
21  .then((response) => {
22    response.json().then((data) => {
23      console.log(data);
24    });
25  })
26  .catch((error) => {
27    console.error(error);
28  });

Response

Response Data

Response
Название
Тип / Значение
Описание
data
Profile
Updated profile

Types

Profile
Название
Тип / Значение
Описание
owner
String
The owner of the profile
id
String
The ID of the profile
folder_id
String
The ID of the folder
proxy_id
UUID | null
The ID of the proxy (null if none)
profile_name
String
The name of the profile
profile_notes
String
The notes for the profile
profile_status
UUID | null
The status of the profile (null if not applicable)
profile_tags
UUID[]
Array of UUIDs representing the tags associated with the profile
browser
String
The browser used by the profile
platform
String
The platform used by the profile (macos/windows/linux)
fingerprint
Fingerprint
The fingerprint used by the profile
running
Boolean
Whether the profile is currently running
pinned
Boolean
Whether the profile is currently pinned
worktime
Number
The worktime of the profile in seconds
last_run_at
Timestamp?
The last time the profile was run
created_at
Timestamp
The time the profile was created
updated_at
Timestamp
The time the profile was last updated
proxy
Proxy | null
The proxy used by the profile
Fingerprint
Название
Тип / Значение
Описание
major
Number
The major version of the fingerprint
os
String
The operating system of the fingerprint
screen
Screen
The screen details of the fingerprint
fonts
String[]
Array of fonts installed in the system
webrtc_pref
String
WebRTC settings
canvas_pref
String
Canvas settings
webgl_pref
String
WebGL settings
media_devices
null
Media devices information
ports_protection
string[]
Array of protected ports
geolocation
null
Geolocation settings
client_rects
null
Client rects settings
hints
...
Hints about the device
navigator
...
Navigator information
webgl
...
WebGL information
webgpu
...
WebGPU information
crc
String
CRC value
Screen
Название
Тип / Значение
Описание
width
Number
The width of the screen
height
Number
The height of the screen
pixel_ratio
Number
The pixel ratio of the screen
avail_width
Number
The available width of the screen
avail_height
Number
The available height of the screen
avail_top
Number
The available top position of the screen
avail_left
Number
The available left position of the screen
color_depth
Number
The color depth of the screen
pixel_depth
Number
The pixel depth of the screen