---
title: "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."
method: POST
path: "/profiles/{profileId}/start"
tags: ["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.

`POST /profiles/{profileId}/start`

## Path parameters

- `profileId` string, uuid, required

## Request body

- BrowserSettings — Extra settings and preferences that can be applied to the browser at startup.
  - `arguments` string[], nullable — Command line arguments that can be passed to the browser at startup. This applies to both Chroma and Junglefox browsers. Do not include the starting double dash (--).
  - `preferences` Preference[], nullable — List of preferences for browsers that can be passed at startup. In case of Chromium based options it will be a user profile preference. In case of Firefox profiles it will be a preference.
    - `key` string, required — Key of the preference
    - `value` unknown, required
  - `additionalOptions` Preference[], nullable — Special options available only in Kameleo, such as device scale factor for mobile emulated profiles. See the docs for more details.
    - `key` string, required — Key of the preference
    - `value` unknown, required

## Response `200`

OK.

- StatusResponse — Status information about the profile
  - `lifetimeState` 'created' | 'starting' | 'running' | 'terminating' | 'terminated' | 'locked' | 'loading' | 'unknown', required — 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.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden
- `404` — Profile not found.
- `409` — Profile already running.
- `429` — Too Many Requests
- `503` — Service Unavailable
- `default` — Error

---

[API](https://skmtc.net/kameleo-io/apis/kameleo-local-api.md) · [All operations](https://skmtc.net/kameleo-io/apis/kameleo-local-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kameleo-io/kameleo-local-api/revisions/dc959e78ce25/schema)