Skip to content

Sessions

A session is a single cloud browser instance, addressable by session_id, that an agent drives via per-tool calls (navigate, click, type, assert, snapshot, screenshot).

session.create → session.navigate → ...drive... → session.close
↑
(or idle/max-duration reaper)

Sessions end when:

  • You call kifas.session.close explicitly.
  • idle_timeout_seconds (default 90) elapses without activity.
  • max_duration_seconds (default 1800 live; 300 test) is hit.
  • A tier limit (concurrent sessions, monthly browser-minutes) is exceeded.

Sessions inherit the mode of the API key that created them. The docs sandbox uses a test-mode key (kifas_test_*) capped at 5-minute max-duration; production agents typically use live-mode keys (kifas_live_*) with the full 30-minute cap.

Plan Concurrent sessions Monthly browser-minutes
Free 1 100
Starter 5 1,000
Team 25 10,000
Business custom custom

See tier limits for the full pricing matrix.

Internally we hold one CDP connection per active session, kept warm so subsequent calls are sub-100ms after the first. The pool reaps idle sessions automatically; your client never has to think about it.