Solari Browserdocs

Profiles endpoints

Create, list, save, and delete browser profiles.

POST /profiles

Create an empty profile.

POST /profiles HTTP/1.1
Host: api.solaribrowser.com
Authorization: Bearer sb_live_…
Content-Type: application/json

{ "name": "amazon-seller" }

Response — 200 OK

{
  "id":   "prof_abc123",
  "name": "amazon-seller"
}

GET /profiles

List every profile in your org.

GET /profiles HTTP/1.1
Host: api.solaribrowser.com
Authorization: Bearer sb_live_…

Response — 200 OK

[
  { "id": "prof_abc123", "name": "amazon-seller" },
  { "id": "prof_def456", "name": "shopify-staging" }
]

DELETE /profiles/:id

Delete the profile. Idempotent.

DELETE /profiles/prof_abc123 HTTP/1.1
Host: api.solaribrowser.com
Authorization: Bearer sb_live_…

POST /profiles/:id/save

Save the storageState. Accepts Playwright's standard shape.

POST /profiles/prof_abc123/save HTTP/1.1
Host: api.solaribrowser.com
Authorization: Bearer sb_live_…
Content-Type: application/json

{
  "storageState": {
    "cookies": [
      {
        "name":     "session",
        "value":    "eyJhbGciOi…",
        "domain":   ".example.com",
        "path":     "/",
        "expires":  1764508800,
        "httpOnly": true,
        "secure":   true,
        "sameSite": "Lax"
      }
    ],
    "origins": [
      {
        "origin": "https://example.com",
        "localStorage": [
          { "name": "user_id", "value": "12345" }
        ]
      }
    ]
  }
}

Response — 200 OK

{
  "version":   3,
  "sizeBytes": 4218
}