Profiles

Create Profile

Profiles allow you to preserve the state of the browser between tasks.

They are most commonly used to allow users to preserve the log-in state in the agent between tasks. You'd normally create one profile per user and then use it for all their tasks.

You can set a user_id when creating a profile to associate it with a user in your system. This allows you to later search for the profile using the GET /profiles endpoint with a query parameter.

post/profiles

Request

  • Base URL: https://api.browser-use.com/api/v4
  • URL: https://api.browser-use.com/api/v4/profiles
  • Auth: API key in header X-Browser-Use-API-Key

Request body

namestring nullable

Optional name for the profile

userIdstring nullable

Your internal user identifier for this profile. Use this to associate a profile with a user in your system.

Response

Successful Response

idstring uuid required

Unique identifier for the profile

userIdstring nullable

Your internal user identifier for this profile. Use this to associate a profile with a user in your system.

namestring nullable

Optional name for the profile

lastUsedAtstring date-time nullable

Timestamp when the profile was last used

createdAtstring date-time required

Timestamp when the profile was created

updatedAtstring date-time required

Timestamp when the profile was last updated

cookieDomainsstring[] nullable

List of domain URLs that have cookies stored for this profile

Changes

No recorded changes to this operation across all 1 revision of this API.