Profile

Starts the selected profile by transitioning its status to 'starting', launching the kernel (Chroma or Junglefox) associated with the profile, and then changing its status to 'running'. If there is an error during start-up, it will be 'terminated'. Note that the required kernel might not be available locally, so it may be downloaded during the profile start. Optional command line arguments or settings can be passed to the browser engines.

Changed on Aug 3, 2026

post/profiles/{profileId}/start

Request

Base URL
http://localhost:5050
Auth
none declared
TypeScript
https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/profiles/:profileId/start/post.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

argumentsstring[] nullable

Command line arguments that can be passed to the browser at startup. This applies to both Chroma and Junglefox browsers.

Example request

{
  "arguments": [
    "--disable-notifications"
  ],
  "preferences": [
    {
      "key": "signin.allowed_on_next_startup",
      "value": false
    }
  ],
  "additionalOptions": [
    {
      "key": "profile.managed_default_content_settings.images",
      "value": 2
    }
  ]
}

Response

OK.

Represents the lifetime states of a profile, indicating which actions can be performed with the associated browser engine at each state. Possible values are:

Created: Profile is created; the associated browser engine is not started.
Starting: The associated browser engine is starting.
Running: The associated browser engine is currently running.
Terminating: The associated browser engine is in the process of terminating.
Terminated: The associated browser engine is not running but has been started at least once.
Locked: The profile is currently being used by another user.
Loading: The profile data or the browser engine is syncing with the cloud storage.
Unknown: State of the profile is undefined.

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
- 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
- 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
- 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
- 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 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 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
- 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
- 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 (4 revisions)