Sessions API

List Sessions

GET /sessions

Returns all active sessions.

curl http://127.0.0.1:9090/sessions

[
  {
    "id": "sess_a1b2c3d4",
    "profile": "windows",
    "created_at": "2026-08-12T10:00:00Z",
    "current_url": "https://example.com"
  }
]

Create Session

POST /sessions

Field	Type	Default	Description
profile	string	"windows"	Fingerprint profile
proxy	string	(none)	Proxy URL for this session

curl -X POST http://127.0.0.1:9090/sessions \
  -H 'content-type: application/json' \
  -d '{"profile": "macos", "proxy": "socks5://127.0.0.1:1080"}'

{
  "id": "sess_b2c3d4e5",
  "profile": "macos",
  "created_at": "2026-08-12T10:01:00Z"
}

Close Session

DELETE /sessions/{id}

curl -X DELETE http://127.0.0.1:9090/sessions/sess_a1b2c3d4

Returns 204 No Content on success.

Navigate Session

POST /sessions/{id}/navigate

Field	Type	Description
url	string	Target URL
wait	number	Wait time in ms after load (optional)

curl -X POST http://127.0.0.1:9090/sessions/sess_a1b2c3d4/navigate \
  -H 'content-type: application/json' \
  -d '{"url": "https://example.com", "wait": 3000}'

Execute JavaScript

POST /sessions/{id}/execute

Field	Type	Description
script	string	JavaScript to execute

curl -X POST http://127.0.0.1:9090/sessions/sess_a1b2c3d4/execute \
  -H 'content-type: application/json' \
  -d '{"script": "document.title"}'

{
  "result": "Example Domain"
}