From 5026939f2525b1ae28e2fad9737412e3a9eaaab2 Mon Sep 17 00:00:00 2001 From: chruffins <23645059+chruffins@users.noreply.github.com> Date: Fri, 18 Sep 2026 14:43:44 +0000 Subject: [PATCH] Document current concurrency usage --- info/projects.mdx | 6 ++++-- reference/cli/org.mdx | 4 +++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/info/projects.mdx b/info/projects.mdx index 22b61aca..b9f37a88 100644 --- a/info/projects.mdx +++ b/info/projects.mdx @@ -321,11 +321,13 @@ Concurrency limits control how many browsers can run at once. To control monthly | Method | Path | Description | | --- | --- | --- | -| `GET` | `/org/limits` | Get the org concurrency limit and the default per-project cap | -| `PATCH` | `/org/limits` | Set the default per-project cap (send `0` to clear it) | +| `GET` | `/org/limits` | Get the effective org concurrency limit, current usage, available capacity, and default per-project cap | +| `PATCH` | `/org/limits` | Set the default per-project cap (send `0` to clear it) and return the updated limits and usage | | `GET` | `/org/projects/{id}/limits` | Get a single project's limit overrides | | `PATCH` | `/org/projects/{id}/limits` | Set a single project's limit overrides (send `0` to clear a cap) | +The `GET` and `PATCH` responses include `concurrent_sessions_used` and `concurrent_sessions_available`. Usage includes active on-demand browser sessions and browser pool reservations. `concurrent_sessions_available` is the effective organization limit minus current usage, floored at zero. Both fields are `null` when current usage can't be read. + `max_pooled_sessions` is deprecated. Pooled browsers now count toward `max_concurrent_sessions`, and requests that set `max_pooled_sessions` return a `400`. diff --git a/reference/cli/org.mdx b/reference/cli/org.mdx index ad928a87..b4f9e258 100644 --- a/reference/cli/org.mdx +++ b/reference/cli/org.mdx @@ -25,7 +25,9 @@ kernel org entitlements --output json ## `kernel org limits get` -Show the organization's maximum concurrent browser sessions and the default per-project cap. +Show the organization's effective concurrency limits, current browser usage, available capacity, and default per-project cap. + +The JSON response includes `concurrent_sessions_used` and `concurrent_sessions_available`. Usage includes active on-demand browser sessions and browser pool reservations. Both fields are `null` when current usage can't be read. | Flag | Description | |------|-------------|