KEkernel
Organization

Update organization limits

Changed on

Set the default per-project concurrency cap applied to projects without an explicit override. Set the value to 0 to remove the default; omit to leave it unchanged. The default cannot exceed the organization's concurrency limit.

patch/org/limits

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/org/limits
  • Auth
    HTTP bearer

Request body

default_project_max_concurrent_sessionsinteger nullable

Default maximum concurrent browsers for projects without an explicit override. Set to 0 to remove the default; omit to leave unchanged. Cannot exceed the organization's concurrency limit.

Response

Organization limits updated

auth_connections_usedinteger required

The organization's current non-deleted managed auth connections, counted org-wide across every project. Compare against max_auth_connections to show remaining capacity before a create is rejected with 403 insufficient_plan.

concurrent_sessions_availableinteger nullable required

Number of concurrent browser slots currently available to the organization. This is the effective concurrency limit minus active on-demand sessions and browser pool reservations, floored at zero. Null when usage cannot be read.

concurrent_sessions_usedinteger nullable required

Current organization-wide concurrent browser usage, including active on-demand sessions and browser pool reservations. Null when usage cannot be read.

default_project_max_concurrent_sessionsinteger nullable

Default maximum concurrent browsers applied to every project that has no explicit per-project override. Null means no org-level default, so such projects are uncapped (only the org-wide limit applies). Applies to existing and newly created projects.

max_auth_connectionsinteger nullable required

Maximum managed auth connections the organization's plan allows. Null means unlimited. Counted org-wide, so it cannot be multiplied across projects.

max_concurrent_sessionsinteger

The organization's effective concurrency limit — the maximum browsers running at once, covering both on-demand sessions and browser pool reservations — from its plan or an override. Read-only and shared across all projects in the org; a per-project default cannot exceed it.

max_vaultsinteger nullable required

Maximum non-deleted vaults allowed org-wide across all projects. Null means unlimited.

min_health_check_interval_secondsinteger required

Smallest health_check_interval the organization's plan accepts on a managed auth connection. Requests below this are rejected with 400. Existing connections stored below the floor are grandfathered until edited.

vaults_usedinteger required

Current non-deleted vault count across all projects in the organization.

Example response

{
  "auth_connections_used": 2,
  "concurrent_sessions_available": 488,
  "concurrent_sessions_used": 12,
  "default_project_max_concurrent_sessions": 10,
  "max_auth_connections": 3,
  "max_concurrent_sessions": 500,
  "max_vaults": 3,
  "min_health_check_interval_seconds": 21600,
  "vaults_used": 2
}

Changes

  • 03b369edee49Revision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 922e9f178510Revision changes
    • info

      added the non-success response with the status