OpenBrowse
v3 API referencev3/profiles

List Profiles

List profiles, paginated, with an optional query to narrow the results.

List Profiles. Send this to your own instance, replacing your-host with the hostname it answers on.

curl -X GET "https://your-host/v3/profiles" \
  -H "Authorization: Bearer $OPENBROWSE_API_KEY"
GET
/v3/profiles

Authorization

HTTPBearer
AuthorizationBearer <token>

In: header

Query Parameters

page?Page
Default1
page_size?Page Size
Default20
query?string|null

Header Parameters

x-browser-use-api-key?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v3/profiles"
{  "items": [    {      "id": "string",      "userId": "string",      "name": "string",      "lastUsedAt": "string",      "createdAt": "string",      "updatedAt": "string",      "cookieDomains": [        "string"      ]    }  ],  "totalItems": 0,  "pageNumber": 0,  "pageSize": 0}

v3 API reference

Every endpoint in the OpenBrowse v3 REST API, the same surface the browser-use-sdk client already speaks, generated from the running application's OpenAPI schema.

Create Profile POST

Create an empty profile, with no cookies and no per-origin storage yet. Fill it by importing a cookie jar, or by letting a session log in while using it.