Profiles & States API
Profiles
Section titled “Profiles”Profiles are persistent Chromium user data directories stored at ~/.brow/profiles/{name}/. They retain cookies, localStorage, and browser state between sessions.
List profiles
Section titled “List profiles”GET /profilesResponse: {"profiles": ["default", "gmail", "github"]}
Delete profile
Section titled “Delete profile”DELETE /profiles/{name}Deletes the profile directory and all its data. Fails with 409 if a
session currently holds that profile — delete the session first.
Response: {"deleted": "gmail"}
States
Section titled “States”States are snapshots of a session’s cookies and storage, saved as JSON files at ~/.brow/states/{name}.json. Unlike profiles (which are full Chromium directories), states are portable and can be restored into any session.
Save state
Section titled “Save state”POST /states/save{"name": "logged-in-github", "session_id": "1"}Response: {"saved": "logged-in-github"}
Restore state
Section titled “Restore state”POST /states/restore{"name": "logged-in-github", "session_id": "2"}Restores cookies and localStorage into the target session.
Response: {"restored": "logged-in-github"}
List states
Section titled “List states”GET /statesResponse: {"states": ["logged-in-github", "logged-in-gmail"]}