Skip to content

Commit 7fa49b5

Browse files
Jayko001claude
andcommitted
Document unified concurrency limit (CUS-275)
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>
1 parent 9b4640e commit 7fa49b5

3 files changed

Lines changed: 17 additions & 10 deletions

File tree

info/pricing.mdx

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,15 +58,18 @@ Auth sessions are fast (typically 5-30 seconds each). Kernel monitors session he
5858

5959
## Concurrency limits
6060

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.
62+
6163
| Feature | Developer (free + usage) | Hobbyist ($30 / mo + usage) | Start-Up ($200 / mo + usage) | Enterprise |
6264
| --- | --- | --- | --- | --- |
63-
| Reserved browsers ([browser pools](/browsers/pools/overview)) | 0 | 0 | 100 | Custom |
64-
| On-demand browsers | 5 | 10 | 50 | Custom |
65+
| Concurrent browsers | 5 | 10 | 150 | Custom |
6566
| App invocations | 5 | 10 | 50 | Custom |
6667
| App invocations (per-app) | 5 | 10 | 20 | Custom |
6768
| Managed auth health check interval | N/A | 1 hour minimum | 20 minutes minimum | Custom |
6869

69-
> 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.
7073
7174
> 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.
7275

info/projects.mdx

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -320,9 +320,9 @@ if err := client.Projects.Delete(ctx, "proj_abc123"); err != nil {
320320

321321
## Concurrency Limits
322322

323-
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.
324324

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.
326326
- **Per-project limits** — optional caps on individual projects, so one team or environment can't consume the entire org limit.
327327

328328
Per-project caps come from two places:
@@ -336,18 +336,22 @@ A project's effective cap resolves in this order:
336336
2. Otherwise, the organization's default project cap, if set.
337337
3. Otherwise, no per-project cap — only the organization limit applies.
338338

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.
340340

341341
| Method | Path | Description |
342342
| --- | --- | --- |
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 |
344344
| `PATCH` | `/org/limits` | Set the default per-project cap (send `0` to clear it) |
345345
| `GET` | `/org/projects/{id}/limits` | Get a single project's limit overrides |
346346
| `PATCH` | `/org/projects/{id}/limits` | Set a single project's limit overrides (send `0` to clear a cap) |
347347

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+
348352
### Set an org-wide default
349353

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:
351355

352356
<CodeGroup>
353357
```bash cURL

reference/cli/projects.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,9 +68,9 @@ Update per-project limit overrides. Pass `0` to a limit to remove the cap for th
6868

6969
| Flag | Description |
7070
|------|-------------|
71-
| `--max-concurrent-sessions <n>` | Maximum concurrent browser sessions (0 to remove cap). |
71+
| `--max-concurrent-sessions <n>` | Maximum concurrent browsers, covering both on-demand sessions and browser pool reservations (0 to remove cap). |
7272
| `--max-concurrent-invocations <n>` | Maximum concurrent app invocations (0 to remove cap). |
73-
| `--max-pooled-sessions <n>` | Maximum pooled sessions capacity (0 to remove cap). |
73+
| `--max-pooled-sessions <n>` | Deprecated — pooled browsers now count toward `--max-concurrent-sessions`. |
7474
| `--output json`, `-o json` | Output raw JSON object. |
7575

7676
```bash

0 commit comments

Comments
 (0)