Skip to navigation

Update profile

View as Markdown

Update a profile — a partial update: send only the fields you want to change. The body has the same shape as Create profile (same fields, same { mode, value } rules).

Any field you omit keeps its current value — fingerprint, proxy, name, note, folder, everything. Only the profile id in the path is required; even system is optional here (preserved when omitted). When sending a rotating residential proxy, omit session_sticky_ttl to preserve its current sticky duration.

For a quick change of just name / note / folder / proxy, Quick update profile is a lighter alternative.

Use top-level sync_cookie, sync_password, and sync_bookmark (numeric 0 or 1) to change close-upload settings. Omitted switches keep their saved values; 0 explicitly disables upload for that type. If the profile is running, changes take effect on its next launch. These switches do not disable startup downloads. Quick update does not support these fields.

Authentication

X-API-Keystring
API Key generated in the FlashID app.

Path parameters

idstringRequired
Profile UUID

Request

This endpoint expects an object.
sync_passwordenumOptional

Password upload on close. 0 = off, 1 = on (default 0).

Allowed values:
sync_bookmarkenumOptional

Bookmark upload on close. 0 = off, 1 = on (default 1).

Allowed values:
profile_namestringOptional

Display name. Optional (default empty).

notestringOptional

Free-text note. Optional.

folder_uuidstringOptional

Folder to place the profile in. Optional (default “0” = root).

tag_uuidslist of stringsOptional

Tag UUIDs to assign. On create, omit for no tags. On update, omit to preserve current assignments; send [] to clear all assignments. Order is preserved.

cookiestringOptional

Cookies as a plaintext JSON string. Optional (omit for none).

launch_argumentslist of stringsOptional

Custom Chromium launch arguments. Optional (default empty). Each item is one argument.

systemobjectOptional
proxyobjectOptional

Proxy config. Optional — omit the whole object for no proxy. When present, the shape depends on mode.

user_agentobjectOptional

User-Agent. Optional — omit to auto-generate (random).

webrtcobjectOptional

WebRTC. mode: off | real | auto | manual (default auto).

timezoneobjectOptional

Timezone. mode: auto | manual (default auto).

geo_locationobjectOptional

Geolocation. mode: auto | manual (default auto).

languageobjectOptional

Language. mode: auto | manual (default auto).

do_not_trackobjectOptional

Do Not Track. mode: off | on (default off). No value.

webgpuobjectOptional

WebGPU. mode: off | on (default on). No value.

webgl_infoobjectOptional

WebGL vendor/renderer. mode: real | random | manual (default random).

webglobjectOptional

WebGL image noise. mode: real | noise (default noise).

canvasobjectOptional

Canvas noise. mode: real | noise (default noise).

audio_contextobjectOptional

AudioContext noise. mode: real | noise (default noise).

client_rectsobjectOptional

ClientRects noise. mode: real | noise (default noise).

speech_voicesobjectOptional

Speech voices noise. mode: real | noise (default noise). No value.

screenobjectOptional

Screen resolution. mode: real | manual (default real).

fontsobjectOptional

Fonts. mode: auto | manual (default auto).

cpuobjectOptional

CPU cores (hardwareConcurrency). mode: real | random | manual (default random).

ramobjectOptional

Device memory in GB. mode: real | random | manual (default random).

media_devicesobjectOptional

Media devices. mode: real | auto | manual (default auto).

device_nameobjectOptional

Device name. mode: real | random | manual (default random).

mac_addressobjectOptional

MAC address. mode: real | random | manual (default random).

Response

Updated
successboolean
codeinteger
dataobjectOptional