Profile

Update an existing profile’s settings by providing the new configuration options in the request body. Use this to modify aspects like spoofing options or proxy settings, then receive the updated profile details.

Changed on Aug 3, 2026

put/profiles/{profileId}

Request

Base URL
http://localhost:5050
Auth
none declared
TypeScript
https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/profiles/:profileId/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

profileIdstring uuid required

The unique identifier of the profile

Request body

namestring nullable

Profile name property. The value obtained by file name for existing profiles. For new profiles the value is generated by a random name generator.

folderIdstring uuid nullable

Id of the folder the profile should be moved to. If null it won't be changed, if empty (00000000-0000-0000-0000-000000000000) it will be moved to root.

tagsstring[] nullable

Profile tags

canvas'intelligent' | 'noise' | 'block' | 'off'

Specifies how the canvas will be spoofed. Possible values: 'intelligent': Use intelligent canvas spoofing. This will result non-unique canvas fingerprints. 'noise': Add some noise to canvas generation. 'block': Completely block the 2D API. 'off': Turn off the spoofing, use the original settings.

webgl'noise' | 'block' | 'off'

Specifies how the WebGL will be spoofed. Possible values: 'noise': Add some noise to the WebGL generation 'block': Completely block the 3D API 'off': Turn off the spoofing, use the original settings

audio'off' | 'noise' | 'block'

Specifies how the audio will be spoofed. Possible values: 'noise': Add some noise to the Audio generation 'block': Completely block the Audio API 'off': Turn off the spoofing, use the original settings

fonts'automatic' | 'off'

Specifies how the fonts will be spoofed. Possible values: 'automatic': Spoof fonts based on the browser fingerpint. 'off': Don't spoof fonts, use the real fonts of your machine.

languagestring nullable

A language or a comma-separated list of languages for the profile. ISO 639-1 language and optionally ISO 3166-1 region code.

startPagestring uri nullable

This website will be opened in the browser when the profile launches.

passwordManager'enabled' | 'disabled'

Defines whether the browser can save login credentials. Possible values are: 'enabled': Credential saving is allowed. 'disabled': Credential saving is blocked.

extensionsstring[] nullable

A list of extensions or addons should be loaded to the browser when starting the profile. For extensions that are added now, it should be an absolute path. For extensions already added to the profile in a previous update, the name is only enough. For chrome and edge use CRX3 format extensions. For firefox use signed xpi format addons.

notesstring nullable

A free text including any notes written by the user.

storage'local' | 'cloud'

Example request

{
  "tags": [
    "facebook",
    "instagram"
  ],
  "webglMeta": {
    "extra": {
      "vendor": "Google Inc.",
      "renderer": "ANGLE (Intel(R) HD Graphics 630 Direct3D11 vs_5_0 ps_5_0)"
    }
  },
  "geolocation": {
    "extra": {
      "latitude": 59.43984,
      "longitude": 24.75815
    }
  },
  "proxy": {
    "extra": {
      "host": "127.0.0.1",
      "port": 9951,
      "id": "username",
      "secret": "password"
    }
  },
  "webRtc": {
    "extra": {
      "publicIp": "193.40.239.9"
    }
  },
  "language": "en-US,en",
  "startPage": "https://kameleo.io/",
  "extensions": [
    "C:\\Users\\Windows 10\\Kameleo Extensions\\necessary-extension.crx"
  ],
  "notes": "I used this profile for affiliate marketing."
}

Response

OK.

idstring uuid required

A unique identifier of the profile

namestring required

Profile name property. The value obtained by file name for existing profiles. For new profiles the value is generated by a random name generator.

tagsstring[] required

Profile tags

createdAtstring date-time required

Date when the profile was created.

canvas'intelligent' | 'noise' | 'block' | 'off' required

webgl'noise' | 'block' | 'off' required

Specifies how the WebGL will be spoofed. Possible values: 'noise': Add some noise to the WebGL generation 'block': Completely block the 3D API 'off': Turn off the spoofing, use the original settings

audio'off' | 'noise' | 'block' required

fonts'automatic' | 'off' required

Specifies how the fonts will be spoofed. Possible values: 'automatic': Spoof fonts based on the browser fingerpint. 'off': Don't spoof fonts, use the real fonts of your machine.

languagestring required

A language or a comma-separated list of languages for the profile. ISO 639-1 language and optionally ISO 3166-1 region code.

startPagestring required

This website will be opened in the browser when the profile launches.

passwordManager'enabled' | 'disabled' required

Defines whether the browser can save login credentials. Possible values are: 'enabled': Credential saving is allowed. 'disabled': Credential saving is blocked.

extensionsstring[] required

A list of extensions or addons that will be loaded to the profile when the profile is started. For chrome and edge use CRX3 format extensions. For firefox use signed xpi format addons.

notesstring required

A free text including any notes written by the user.

storage'local' | 'cloud'

folderIdstring uuid nullable

A unique identifier of the containing folder or empty (00000000-0000-0000-0000-000000000000) if it is not in folder.

Example response

{
  "id": "a7cafbbe-6bc0-4575-8c6e-f1adf391f180",
  "name": "mystic-turtle",
  "tags": [
    "facebook",
    "instagram"
  ],
  "createdAt": "2020-05-02T03:10:32.2452701+10:00",
  "fingerprint": {
    "id": "555b894595b5cd242ead1533218a5ee93dd7c7ebfbff4dccb80fdb112f6cda27",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36",
    "device": {
      "type": "desktop",
      "name": "Samsung SM-A705FN"
    },
    "os": {
      "family": "windows",
      "version": "10.15.4",
      "platform": "64"
    },
    "browser": {
      "product": "chrome",
      "major": 81,
      "version": "81.0.4044"
    },
    "webglMeta": {
      "vendor": "Google Inc. (AMD)",
      "renderer": "ANGLE (AMD, AMD Radeon(TM) RX Vega 11 Graphics Direct3D11 vs_5_0 ps_5_0, D3D11)"
    },
    "resolution": "1920x1080",
    "fonts": [
      "Arial",
      "Tahoma"
    ]
  },
  "webglMeta": {
    "extra": {
      "vendor": "Google Inc.",
      "renderer": "ANGLE (Intel(R) HD Graphics 630 Direct3D11 vs_5_0 ps_5_0)"
    }
  },
  "geolocation": {
    "extra": {
      "latitude": 59.43984,
      "longitude": 24.75815
    }
  },
  "proxy": {
    "extra": {
      "host": "127.0.0.1",
      "port": 9951,
      "id": "username",
      "secret": "password"
    }
  },
  "webRtc": {
    "extra": {
      "publicIp": "193.40.239.9"
    }
  },
  "language": "en-US,en",
  "startPage": "https://whoer.net/",
  "extensions": [
    "C:\\Users\\Windows 10\\Kameleo Extensions\\necessary-extension.crx"
  ],
  "notes": "I used this profile for ad verification.",
  "folderId": "c7aafbbe-b6c0-5475-c66e-1fadf39180f1"
}

Changes

Aug 3, 2026dc959e78ce25 Revision changes
- warning
  added the new running_mobile_profiles_limit_reached enum value to the //// response property for the response status
- warning
  added the new running_mobile_profiles_limit_reached enum value to the //// response property for the response status
- warning
  added the new running_mobile_profiles_limit_reached enum value to the //// response property for the response status
Jun 16, 20264d1d53a322e2 Revision changes
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (3 revisions)