TabGeckoPATCH
/api/v1/profiles/{id}
Profil bearbeiten; Kern und Betriebssystem sind nach der Anlage fest
Anfrage#
POSIX-Shell · curl
curl --fail-with-body --request PATCH \
"$ADBR_API_URL/api/v1/profiles/{id}" \
-H "Authorization: Bearer $ADBR_API_TOKEN" \
-H "Content-Type: application/json" \
--data @request.jsonVerwende lokale Adresse und Token aus API & MCP. Ersetze Pfadplatzhalter wie {id} durch tatsächliche IDs. Erstelle request.json anhand des folgenden Körperschemas, bevor du den Befehl ausführst.
Authentifizierung und Rechte#
Authentifizierung: Bearer-Token
Scopes: profiles:write
Alle aufgeführten Scopes sind erforderlich; admin erfüllt Scope-Prüfungen. Kontorechte, Anfrageinhalt, Tresorzustand und Ressourcenrechte können weitere Voraussetzungen setzen.
Parameter#
| Parameter | Ort | Pflicht | Beschreibung |
|---|---|---|---|
operation_id | query | Nein | |
id | path | Ja |
Vollständige Parameterschemas
OpenAPI JSON
[
{
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9-]{16,64}$"
},
"in": "query",
"name": "operation_id",
"required": false
},
{
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"in": "path",
"name": "id",
"required": true
}
]Anfragekörper#
Erforderlich.
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
name | string | Nein | |
notes | string | null | Nein | Geänderte Notizen dürfen bis zu 400 Unicode-Codepoints enthalten. Unveränderte vorhandene Notizen bleiben erhalten. |
group_id | string | null | Nein | |
group_name | string | Nein | |
tag_ids | array | Nein | |
tags | array | Nein | |
status_id | string | null | Nein | |
pinned | boolean | Nein | |
color | string | null | Nein | |
custom_no | string | null | Nein | |
engine | union | Nein | |
engine_version | string | Nein | |
engine_auto_update | boolean | Nein | |
os | union | Nein | |
os_version | string | null | Nein | |
user_agent | string | null | Nein | |
fingerprint_overrides | object | Nein | |
proxy | object | Nein | |
ip_checker | string | null | Nein | |
browser_options | object | Nein | |
net | object | Nein | |
start_mode | union | Nein | |
start_urls | array | Nein | |
open_account_pages | boolean | Nein | |
homepage | string | null | Nein | |
launch_args | array | Nein | |
extension_set_id | string | null | Nein | |
storage_options | object | Nein | |
clear_on_close | object | Nein | |
cache_dir_override | string | null | Nein | |
accounts | array | Nein | |
fingerprint_seeds | object | Nein | |
row_version | integer | Nein | |
regenerate_fingerprint | boolean | Nein |
Vollständiges Körperschema
OpenAPI JSON
{
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 5000,
"description": "Changed notes may contain up to 400 Unicode code points. Unchanged existing notes are preserved."
},
"group_id": {
"type": [
"string",
"null"
]
},
"group_name": {
"type": "string",
"maxLength": 100
},
"tag_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"maxItems": 30
},
"status_id": {
"type": [
"string",
"null"
]
},
"pinned": {
"type": "boolean"
},
"color": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"custom_no": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"engine": {
"anyOf": [
{
"type": "string",
"enum": [
"chromium"
]
},
{
"type": "string",
"enum": [
"firefox"
]
}
]
},
"engine_version": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"engine_auto_update": {
"type": "boolean"
},
"os": {
"anyOf": [
{
"type": "string",
"enum": [
"windows"
]
},
{
"type": "string",
"enum": [
"macos"
]
},
{
"type": "string",
"enum": [
"linux"
]
},
{
"type": "string",
"enum": [
"android"
]
},
{
"type": "string",
"enum": [
"ios"
]
}
]
},
"os_version": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"user_agent": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"fingerprint_overrides": {
"type": "object",
"additionalProperties": {}
},
"proxy": {
"type": "object",
"required": [
"mode"
],
"properties": {
"ssh_private_key": {
"type": [
"string",
"null"
],
"maxLength": 65536
},
"ssh_key_passphrase": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"mode": {
"anyOf": [
{
"type": "string",
"enum": [
"none"
]
},
{
"type": "string",
"enum": [
"ref"
]
},
{
"type": "string",
"enum": [
"inline"
]
}
]
},
"proxy_id": {
"type": [
"string",
"null"
]
},
"proxy_group_id": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"ssh_host_key": {
"type": [
"string",
"null"
],
"pattern": "^SHA256:[A-Za-z0-9+/]{43}$"
},
"protocol": {
"anyOf": [
{
"type": "string",
"enum": [
"http"
]
},
{
"type": "string",
"enum": [
"https"
]
},
{
"type": "string",
"enum": [
"socks4"
]
},
{
"type": "string",
"enum": [
"socks4a"
]
},
{
"type": "string",
"enum": [
"socks5"
]
},
{
"type": "string",
"enum": [
"socks5h"
]
},
{
"type": "string",
"enum": [
"ssh"
]
}
]
},
"host": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535
},
"username": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"password": {
"type": [
"string",
"null"
],
"maxLength": 1024
}
},
"additionalProperties": false
},
"ip_checker": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"browser_options": {
"type": "object",
"properties": {
"block_images": {
"type": "boolean"
},
"block_video": {
"type": "boolean"
},
"block_audio": {
"type": "boolean"
},
"block_notifications": {
"type": "boolean"
},
"block_password_view": {
"type": "boolean"
},
"block_password_save": {
"type": "boolean"
},
"block_extension_pages": {
"type": "boolean"
},
"block_translation": {
"type": "boolean"
},
"block_devtools": {
"type": "boolean"
},
"local_network": {
"type": "object",
"required": [
"blocked",
"allowed_ports"
],
"properties": {
"blocked": {
"type": "boolean"
},
"allowed_ports": {
"type": "string",
"maxLength": 1536
}
},
"additionalProperties": false
},
"taskbar_icon": {
"anyOf": [
{
"type": "string",
"minLength": 50,
"maxLength": 393216
},
{
"type": "null"
}
]
},
"ui_language": {
"anyOf": [
{
"type": "string",
"minLength": 2,
"maxLength": 35
},
{
"type": "null"
}
]
},
"tls_cipher_blocklist": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"secure_dns": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"off"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"server"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"secure"
]
},
"server": {
"type": "string",
"minLength": 9,
"maxLength": 2048
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"net": {
"type": "object",
"additionalProperties": {}
},
"start_mode": {
"anyOf": [
{
"type": "string",
"enum": [
"new_tab"
]
},
{
"type": "string",
"enum": [
"last_tabs"
]
},
{
"type": "string",
"enum": [
"urls"
]
},
{
"type": "string",
"enum": [
"last_and_urls"
]
}
]
},
"start_urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048
},
"maxItems": 20
},
"open_account_pages": {
"type": "boolean"
},
"homepage": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"launch_args": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1024
},
"maxItems": 100
},
"extension_set_id": {
"type": [
"string",
"null"
]
},
"storage_options": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"clear_on_close": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"cache_dir_override": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"accounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform_url"
],
"properties": {
"platform_url": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"username": {
"type": [
"string",
"null"
],
"maxLength": 256
},
"password": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"totp_secret": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"sort_order": {
"type": "integer",
"minimum": 0
},
"id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 50
},
"fingerprint_seeds": {
"type": "object",
"required": [
"identity",
"canvas",
"webgl",
"audio",
"clientRects"
],
"properties": {
"identity": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"canvas": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"webgl": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"audio": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"clientRects": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
}
},
"additionalProperties": false
},
"row_version": {
"type": "integer",
"minimum": 1
},
"regenerate_fingerprint": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
}
}Antworten#
200 · Standardantwort
OpenAPI JSON
{
"description": "Default Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id",
"no",
"compat_user_id",
"display_no",
"custom_no",
"folder_key",
"name",
"notes",
"group",
"tags",
"status",
"pinned",
"color",
"engine",
"engine_version",
"engine_auto_update",
"engine_build_last_used",
"os",
"os_version",
"user_agent",
"fingerprint",
"proxy",
"ip_checker",
"browser_options",
"net",
"start_mode",
"start_urls",
"homepage",
"launch_args",
"extension_set_id",
"storage_options",
"clear_on_close",
"cache_dir_override",
"source",
"imported_from",
"runtime_state",
"accounts_count",
"created_at",
"created_by",
"updated_at",
"updated_by",
"last_opened_at",
"last_closed_at",
"last_exit_ip",
"last_exit_country",
"last_proxy_check",
"row_version"
],
"properties": {
"id": {
"type": "string"
},
"no": {
"type": "integer"
},
"compat_user_id": {
"type": "string"
},
"display_no": {
"type": "integer",
"minimum": 1
},
"custom_no": {
"type": [
"null",
"string"
]
},
"folder_key": {
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"type": [
"null",
"string"
]
},
"group": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
}
},
"status": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"pinned": {
"type": "boolean"
},
"color": {
"type": [
"null",
"string"
]
},
"engine": {
"type": "string"
},
"engine_version": {
"type": "string"
},
"engine_auto_update": {
"type": "boolean"
},
"engine_build_last_used": {
"type": [
"null",
"string"
]
},
"os": {
"type": "string"
},
"os_version": {
"type": [
"null",
"string"
]
},
"user_agent": {
"type": [
"null",
"string"
]
},
"fingerprint": {
"type": "object",
"required": [
"id",
"schema",
"overrides",
"seeds"
],
"properties": {
"id": {
"type": "string"
},
"schema": {
"type": "integer"
},
"overrides": {
"type": "object",
"additionalProperties": {}
},
"seeds": {
"type": "object",
"required": [
"identity",
"canvas",
"webgl",
"audio",
"clientRects"
],
"properties": {
"identity": {
"type": "integer"
},
"canvas": {
"type": "integer"
},
"webgl": {
"type": "integer"
},
"audio": {
"type": "integer"
},
"clientRects": {
"type": "integer"
}
}
}
}
},
"proxy": {
"type": "object",
"required": [
"mode",
"proxy_id",
"inline"
],
"properties": {
"mode": {
"type": "string"
},
"proxy_id": {
"type": [
"null",
"string"
]
},
"group_id": {
"type": [
"null",
"string"
]
},
"group_name": {
"type": [
"null",
"string"
]
},
"inline": {
"anyOf": [
{
"type": "object",
"required": [
"protocol",
"host",
"port",
"username",
"password_set",
"ssh_key_set"
],
"properties": {
"protocol": {
"type": "string"
},
"host": {
"type": "string"
},
"port": {
"type": "integer"
},
"username": {
"type": [
"string",
"null"
]
},
"password_set": {
"type": "boolean"
},
"ssh_key_set": {
"type": "boolean"
},
"ssh_host_key": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
}
}
},
"ip_checker": {
"type": [
"null",
"string"
]
},
"browser_options": {
"type": "object",
"properties": {
"block_images": {
"type": "boolean"
},
"block_video": {
"type": "boolean"
},
"block_audio": {
"type": "boolean"
},
"block_notifications": {
"type": "boolean"
},
"block_password_view": {
"type": "boolean"
},
"block_password_save": {
"type": "boolean"
},
"block_extension_pages": {
"type": "boolean"
},
"block_translation": {
"type": "boolean"
},
"block_devtools": {
"type": "boolean"
},
"local_network": {
"type": "object",
"required": [
"blocked",
"allowed_ports"
],
"properties": {
"blocked": {
"type": "boolean"
},
"allowed_ports": {
"type": "string",
"maxLength": 1536
}
},
"additionalProperties": false
},
"taskbar_icon": {
"anyOf": [
{
"type": "string",
"minLength": 50,
"maxLength": 393216
},
{
"type": "null"
}
]
},
"ui_language": {
"anyOf": [
{
"type": "string",
"minLength": 2,
"maxLength": 35
},
{
"type": "null"
}
]
},
"tls_cipher_blocklist": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"secure_dns": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"off"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"server"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"secure"
]
},
"server": {
"type": "string",
"minLength": 9,
"maxLength": 2048
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"net": {
"type": "object",
"additionalProperties": {}
},
"start_mode": {
"type": "string"
},
"start_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"homepage": {
"type": [
"null",
"string"
]
},
"launch_args": {
"type": "array",
"items": {
"type": "string"
}
},
"extension_set_id": {
"type": [
"null",
"string"
]
},
"storage_options": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"clear_on_close": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"cache_dir_override": {
"type": [
"null",
"string"
]
},
"source": {
"type": [
"null",
"string"
]
},
"imported_from": {
"type": [
"null",
"string"
]
},
"runtime_state": {
"type": "string"
},
"accounts_count": {
"type": "integer"
},
"created_at": {
"type": "integer"
},
"created_by": {
"type": "string"
},
"updated_at": {
"type": "integer"
},
"updated_by": {
"type": "string"
},
"last_opened_at": {
"type": [
"null",
"integer"
]
},
"last_closed_at": {
"type": [
"null",
"integer"
]
},
"last_exit_ip": {
"type": [
"null",
"string"
]
},
"last_exit_country": {
"type": [
"null",
"string"
]
},
"last_proxy_check": {
"anyOf": [
{
"type": "object",
"required": [
"ok",
"checked_at",
"error_class",
"error_code",
"protocol_detected",
"ipv4",
"ipv6",
"country",
"region",
"city",
"postal_code",
"latitude",
"longitude",
"accuracy_km",
"timezone",
"utc_offset",
"languages",
"asn",
"as_org",
"latency_ms",
"geo_source",
"duplicate_profiles"
],
"properties": {
"ok": {
"type": "boolean"
},
"checked_at": {
"type": "integer"
},
"error_class": {
"type": [
"null",
"string"
]
},
"error_code": {
"type": [
"null",
"string"
]
},
"protocol_detected": {
"type": [
"null",
"string"
]
},
"ipv4": {
"type": [
"null",
"string"
]
},
"ipv6": {
"type": [
"null",
"string"
]
},
"country": {
"type": [
"null",
"string"
]
},
"region": {
"type": [
"null",
"string"
]
},
"city": {
"type": [
"null",
"string"
]
},
"postal_code": {
"type": [
"null",
"string"
]
},
"latitude": {
"type": [
"null",
"number"
]
},
"longitude": {
"type": [
"null",
"number"
]
},
"accuracy_km": {
"type": [
"null",
"number"
]
},
"timezone": {
"type": [
"null",
"string"
]
},
"utc_offset": {
"type": [
"null",
"string"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"asn": {
"type": [
"null",
"integer"
]
},
"as_org": {
"type": [
"null",
"string"
]
},
"latency_ms": {
"type": "object",
"required": [
"tcp",
"handshake",
"first_byte"
],
"properties": {
"tcp": {
"type": [
"null",
"number"
]
},
"handshake": {
"type": [
"null",
"number"
]
},
"first_byte": {
"type": [
"null",
"number"
]
}
}
},
"geo_source": {
"type": [
"null",
"string"
]
},
"duplicate_profiles": {
"type": "integer"
}
}
},
{
"type": "null"
}
]
},
"row_version": {
"type": "integer"
}
}
}
}
}
}default · HTTP-Fehlerhülle. Status und error.code bezeichnen den Fehler.
OpenAPI JSON
{
"description": "HTTP error envelope. The status and error.code identify the failure.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}Allgemeine Authentifizierungs- und Transportfehler können zusätzlich zu den dokumentierten Antworten auftreten.
OpenAPI-Definition#
Vollständige Operationsdefinition
OpenAPI JSON
{
"summary": "Profil bearbeiten; Kern und Betriebssystem sind nach der Anlage fest",
"tags": [
"Profile"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 5000,
"description": "Changed notes may contain up to 400 Unicode code points. Unchanged existing notes are preserved."
},
"group_id": {
"type": [
"string",
"null"
]
},
"group_name": {
"type": "string",
"maxLength": 100
},
"tag_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 30
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"maxItems": 30
},
"status_id": {
"type": [
"string",
"null"
]
},
"pinned": {
"type": "boolean"
},
"color": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"custom_no": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"engine": {
"anyOf": [
{
"type": "string",
"enum": [
"chromium"
]
},
{
"type": "string",
"enum": [
"firefox"
]
}
]
},
"engine_version": {
"type": "string",
"minLength": 1,
"maxLength": 16
},
"engine_auto_update": {
"type": "boolean"
},
"os": {
"anyOf": [
{
"type": "string",
"enum": [
"windows"
]
},
{
"type": "string",
"enum": [
"macos"
]
},
{
"type": "string",
"enum": [
"linux"
]
},
{
"type": "string",
"enum": [
"android"
]
},
{
"type": "string",
"enum": [
"ios"
]
}
]
},
"os_version": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"user_agent": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"fingerprint_overrides": {
"type": "object",
"additionalProperties": {}
},
"proxy": {
"type": "object",
"required": [
"mode"
],
"properties": {
"ssh_private_key": {
"type": [
"string",
"null"
],
"maxLength": 65536
},
"ssh_key_passphrase": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"mode": {
"anyOf": [
{
"type": "string",
"enum": [
"none"
]
},
{
"type": "string",
"enum": [
"ref"
]
},
{
"type": "string",
"enum": [
"inline"
]
}
]
},
"proxy_id": {
"type": [
"string",
"null"
]
},
"proxy_group_id": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"ssh_host_key": {
"type": [
"string",
"null"
],
"pattern": "^SHA256:[A-Za-z0-9+/]{43}$"
},
"protocol": {
"anyOf": [
{
"type": "string",
"enum": [
"http"
]
},
{
"type": "string",
"enum": [
"https"
]
},
{
"type": "string",
"enum": [
"socks4"
]
},
{
"type": "string",
"enum": [
"socks4a"
]
},
{
"type": "string",
"enum": [
"socks5"
]
},
{
"type": "string",
"enum": [
"socks5h"
]
},
{
"type": "string",
"enum": [
"ssh"
]
}
]
},
"host": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535
},
"username": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"password": {
"type": [
"string",
"null"
],
"maxLength": 1024
}
},
"additionalProperties": false
},
"ip_checker": {
"type": [
"string",
"null"
],
"maxLength": 32
},
"browser_options": {
"type": "object",
"properties": {
"block_images": {
"type": "boolean"
},
"block_video": {
"type": "boolean"
},
"block_audio": {
"type": "boolean"
},
"block_notifications": {
"type": "boolean"
},
"block_password_view": {
"type": "boolean"
},
"block_password_save": {
"type": "boolean"
},
"block_extension_pages": {
"type": "boolean"
},
"block_translation": {
"type": "boolean"
},
"block_devtools": {
"type": "boolean"
},
"local_network": {
"type": "object",
"required": [
"blocked",
"allowed_ports"
],
"properties": {
"blocked": {
"type": "boolean"
},
"allowed_ports": {
"type": "string",
"maxLength": 1536
}
},
"additionalProperties": false
},
"taskbar_icon": {
"anyOf": [
{
"type": "string",
"minLength": 50,
"maxLength": 393216
},
{
"type": "null"
}
]
},
"ui_language": {
"anyOf": [
{
"type": "string",
"minLength": 2,
"maxLength": 35
},
{
"type": "null"
}
]
},
"tls_cipher_blocklist": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"secure_dns": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"off"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"server"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"secure"
]
},
"server": {
"type": "string",
"minLength": 9,
"maxLength": 2048
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"net": {
"type": "object",
"additionalProperties": {}
},
"start_mode": {
"anyOf": [
{
"type": "string",
"enum": [
"new_tab"
]
},
{
"type": "string",
"enum": [
"last_tabs"
]
},
{
"type": "string",
"enum": [
"urls"
]
},
{
"type": "string",
"enum": [
"last_and_urls"
]
}
]
},
"start_urls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048
},
"maxItems": 20
},
"open_account_pages": {
"type": "boolean"
},
"homepage": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"launch_args": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1024
},
"maxItems": 100
},
"extension_set_id": {
"type": [
"string",
"null"
]
},
"storage_options": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"clear_on_close": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"cache_dir_override": {
"type": [
"string",
"null"
],
"maxLength": 512
},
"accounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform_url"
],
"properties": {
"platform_url": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"username": {
"type": [
"string",
"null"
],
"maxLength": 256
},
"password": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"totp_secret": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"notes": {
"type": [
"string",
"null"
],
"maxLength": 1024
},
"sort_order": {
"type": "integer",
"minimum": 0
},
"id": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 50
},
"fingerprint_seeds": {
"type": "object",
"required": [
"identity",
"canvas",
"webgl",
"audio",
"clientRects"
],
"properties": {
"identity": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"canvas": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"webgl": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"audio": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
},
"clientRects": {
"type": "integer",
"minimum": 0,
"maximum": 4294967295
}
},
"additionalProperties": false
},
"row_version": {
"type": "integer",
"minimum": 1
},
"regenerate_fingerprint": {
"type": "boolean"
}
},
"additionalProperties": false
}
}
}
},
"parameters": [
{
"schema": {
"type": "string",
"pattern": "^[a-zA-Z0-9-]{16,64}$"
},
"in": "query",
"name": "operation_id",
"required": false
},
{
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"in": "path",
"name": "id",
"required": true
}
],
"x-required-scopes": [
"profiles:write"
],
"responses": {
"200": {
"description": "Default Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"id",
"no",
"compat_user_id",
"display_no",
"custom_no",
"folder_key",
"name",
"notes",
"group",
"tags",
"status",
"pinned",
"color",
"engine",
"engine_version",
"engine_auto_update",
"engine_build_last_used",
"os",
"os_version",
"user_agent",
"fingerprint",
"proxy",
"ip_checker",
"browser_options",
"net",
"start_mode",
"start_urls",
"homepage",
"launch_args",
"extension_set_id",
"storage_options",
"clear_on_close",
"cache_dir_override",
"source",
"imported_from",
"runtime_state",
"accounts_count",
"created_at",
"created_by",
"updated_at",
"updated_by",
"last_opened_at",
"last_closed_at",
"last_exit_ip",
"last_exit_country",
"last_proxy_check",
"row_version"
],
"properties": {
"id": {
"type": "string"
},
"no": {
"type": "integer"
},
"compat_user_id": {
"type": "string"
},
"display_no": {
"type": "integer",
"minimum": 1
},
"custom_no": {
"type": [
"null",
"string"
]
},
"folder_key": {
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"type": [
"null",
"string"
]
},
"group": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
}
},
"status": {
"anyOf": [
{
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
}
}
},
{
"type": "null"
}
]
},
"pinned": {
"type": "boolean"
},
"color": {
"type": [
"null",
"string"
]
},
"engine": {
"type": "string"
},
"engine_version": {
"type": "string"
},
"engine_auto_update": {
"type": "boolean"
},
"engine_build_last_used": {
"type": [
"null",
"string"
]
},
"os": {
"type": "string"
},
"os_version": {
"type": [
"null",
"string"
]
},
"user_agent": {
"type": [
"null",
"string"
]
},
"fingerprint": {
"type": "object",
"required": [
"id",
"schema",
"overrides",
"seeds"
],
"properties": {
"id": {
"type": "string"
},
"schema": {
"type": "integer"
},
"overrides": {
"type": "object",
"additionalProperties": {}
},
"seeds": {
"type": "object",
"required": [
"identity",
"canvas",
"webgl",
"audio",
"clientRects"
],
"properties": {
"identity": {
"type": "integer"
},
"canvas": {
"type": "integer"
},
"webgl": {
"type": "integer"
},
"audio": {
"type": "integer"
},
"clientRects": {
"type": "integer"
}
}
}
}
},
"proxy": {
"type": "object",
"required": [
"mode",
"proxy_id",
"inline"
],
"properties": {
"mode": {
"type": "string"
},
"proxy_id": {
"type": [
"null",
"string"
]
},
"group_id": {
"type": [
"null",
"string"
]
},
"group_name": {
"type": [
"null",
"string"
]
},
"inline": {
"anyOf": [
{
"type": "object",
"required": [
"protocol",
"host",
"port",
"username",
"password_set",
"ssh_key_set"
],
"properties": {
"protocol": {
"type": "string"
},
"host": {
"type": "string"
},
"port": {
"type": "integer"
},
"username": {
"type": [
"string",
"null"
]
},
"password_set": {
"type": "boolean"
},
"ssh_key_set": {
"type": "boolean"
},
"ssh_host_key": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
}
}
},
"ip_checker": {
"type": [
"null",
"string"
]
},
"browser_options": {
"type": "object",
"properties": {
"block_images": {
"type": "boolean"
},
"block_video": {
"type": "boolean"
},
"block_audio": {
"type": "boolean"
},
"block_notifications": {
"type": "boolean"
},
"block_password_view": {
"type": "boolean"
},
"block_password_save": {
"type": "boolean"
},
"block_extension_pages": {
"type": "boolean"
},
"block_translation": {
"type": "boolean"
},
"block_devtools": {
"type": "boolean"
},
"local_network": {
"type": "object",
"required": [
"blocked",
"allowed_ports"
],
"properties": {
"blocked": {
"type": "boolean"
},
"allowed_ports": {
"type": "string",
"maxLength": 1536
}
},
"additionalProperties": false
},
"taskbar_icon": {
"anyOf": [
{
"type": "string",
"minLength": 50,
"maxLength": 393216
},
{
"type": "null"
}
]
},
"ui_language": {
"anyOf": [
{
"type": "string",
"minLength": 2,
"maxLength": 35
},
{
"type": "null"
}
]
},
"tls_cipher_blocklist": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 256
},
{
"type": "null"
}
]
},
"secure_dns": {
"anyOf": [
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"off"
]
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"server"
],
"properties": {
"mode": {
"type": "string",
"enum": [
"secure"
]
},
"server": {
"type": "string",
"minLength": 9,
"maxLength": 2048
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"net": {
"type": "object",
"additionalProperties": {}
},
"start_mode": {
"type": "string"
},
"start_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"homepage": {
"type": [
"null",
"string"
]
},
"launch_args": {
"type": "array",
"items": {
"type": "string"
}
},
"extension_set_id": {
"type": [
"null",
"string"
]
},
"storage_options": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"clear_on_close": {
"type": "object",
"additionalProperties": {
"type": "boolean"
}
},
"cache_dir_override": {
"type": [
"null",
"string"
]
},
"source": {
"type": [
"null",
"string"
]
},
"imported_from": {
"type": [
"null",
"string"
]
},
"runtime_state": {
"type": "string"
},
"accounts_count": {
"type": "integer"
},
"created_at": {
"type": "integer"
},
"created_by": {
"type": "string"
},
"updated_at": {
"type": "integer"
},
"updated_by": {
"type": "string"
},
"last_opened_at": {
"type": [
"null",
"integer"
]
},
"last_closed_at": {
"type": [
"null",
"integer"
]
},
"last_exit_ip": {
"type": [
"null",
"string"
]
},
"last_exit_country": {
"type": [
"null",
"string"
]
},
"last_proxy_check": {
"anyOf": [
{
"type": "object",
"required": [
"ok",
"checked_at",
"error_class",
"error_code",
"protocol_detected",
"ipv4",
"ipv6",
"country",
"region",
"city",
"postal_code",
"latitude",
"longitude",
"accuracy_km",
"timezone",
"utc_offset",
"languages",
"asn",
"as_org",
"latency_ms",
"geo_source",
"duplicate_profiles"
],
"properties": {
"ok": {
"type": "boolean"
},
"checked_at": {
"type": "integer"
},
"error_class": {
"type": [
"null",
"string"
]
},
"error_code": {
"type": [
"null",
"string"
]
},
"protocol_detected": {
"type": [
"null",
"string"
]
},
"ipv4": {
"type": [
"null",
"string"
]
},
"ipv6": {
"type": [
"null",
"string"
]
},
"country": {
"type": [
"null",
"string"
]
},
"region": {
"type": [
"null",
"string"
]
},
"city": {
"type": [
"null",
"string"
]
},
"postal_code": {
"type": [
"null",
"string"
]
},
"latitude": {
"type": [
"null",
"number"
]
},
"longitude": {
"type": [
"null",
"number"
]
},
"accuracy_km": {
"type": [
"null",
"number"
]
},
"timezone": {
"type": [
"null",
"string"
]
},
"utc_offset": {
"type": [
"null",
"string"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"asn": {
"type": [
"null",
"integer"
]
},
"as_org": {
"type": [
"null",
"string"
]
},
"latency_ms": {
"type": "object",
"required": [
"tcp",
"handshake",
"first_byte"
],
"properties": {
"tcp": {
"type": [
"null",
"number"
]
},
"handshake": {
"type": [
"null",
"number"
]
},
"first_byte": {
"type": [
"null",
"number"
]
}
}
},
"geo_source": {
"type": [
"null",
"string"
]
},
"duplicate_profiles": {
"type": "integer"
}
}
},
{
"type": "null"
}
]
},
"row_version": {
"type": "integer"
}
}
}
}
}
},
"default": {
"description": "HTTP error envelope. The status and error.code identify the failure.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}