You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Consolidate on-demand and browser-pool concurrency limits into a single
concurrency limit across browsers.create() and pool acquire in pricing,
projects, and CLI reference docs.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: info/pricing.mdx
+6-3Lines changed: 6 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,15 +58,18 @@ Auth sessions are fast (typically 5-30 seconds each). Kernel monitors session he
58
58
59
59
## Concurrency limits
60
60
61
+
Kernel enforces a single concurrency limit covering all browsers you run at once — whether created on demand with `browsers.create()` or reserved in a [browser pool](/browsers/pools/overview). Your full limit is available to either API in any mix.
> Note: Browsers in [Standby Mode](/browsers/standby) count against on-demand concurrency limits.
70
+
> Note: Reserved capacity in a [browser pool](/browsers/pools/overview) counts toward your concurrency limit whether or not the browsers are currently acquired — a pool sized to 40 browsers uses 40 of your limit. Browser pools are available on Start-Up and Enterprise plans.
71
+
72
+
> Note: Browsers in [Standby Mode](/browsers/standby) count against your concurrency limit.
70
73
71
74
> Note: Limits are org-wide by default unless stated otherwise. `Managed auth profiles` refer to profiles with active auth connections that Kernel maintains using your stored [Credentials](/auth/credentials) or [1Password connection](/integrations/1password). A single profile can have multiple auth connections (one per domain) — see [Profiles](/auth/profiles#multiple-auth-connections-per-profile) for details.
Kernel caps how many browser sessions can run at once, at two levels:
323
+
Kernel caps how many browsers can run at once, at two levels. A single limit covers both on-demand browsers (`browsers.create()`) and [browser pools](/browsers/pools/overview) — standalone sessions and reserved pool capacity count against the same cap.
324
324
325
-
-**Organization limit** — the total concurrent sessions allowed across your whole organization, determined by your plan. Every session counts against it.
325
+
-**Organization limit** — the total concurrent browsers allowed across your whole organization, determined by your plan. Every browser session and every reserved pool slot counts against it.
326
326
-**Per-project limits** — optional caps on individual projects, so one team or environment can't consume the entire org limit.
327
327
328
328
Per-project caps come from two places:
@@ -336,18 +336,22 @@ A project's effective cap resolves in this order:
336
336
2. Otherwise, the organization's default project cap, if set.
337
337
3. Otherwise, no per-project cap — only the organization limit applies.
338
338
339
-
A per-project cap never lets a project exceed your organization's concurrent-session limit.
339
+
A per-project cap never lets a project exceed your organization's concurrency limit.
340
340
341
341
| Method | Path | Description |
342
342
| --- | --- | --- |
343
-
|`GET`|`/org/limits`| Get the org concurrent-session limit and the default per-project cap |
343
+
|`GET`|`/org/limits`| Get the org concurrency limit and the default per-project cap |
344
344
|`PATCH`|`/org/limits`| Set the default per-project cap (send `0` to clear it) |
345
345
|`GET`|`/org/projects/{id}/limits`| Get a single project's limit overrides |
346
346
|`PATCH`|`/org/projects/{id}/limits`| Set a single project's limit overrides (send `0` to clear a cap) |
347
347
348
+
<Info>
349
+
`max_pooled_sessions` is deprecated. Pooled browsers now count toward `max_concurrent_sessions`, and requests that set `max_pooled_sessions` return a `400`.
350
+
</Info>
351
+
348
352
### Set an org-wide default
349
353
350
-
Apply a default of 10 concurrent sessions to every project that doesn't have its own override:
354
+
Apply a default of 10 concurrent browsers to every project that doesn't have its own override:
0 commit comments