v4

latestOpenAPI 3.1.02026-08-086635375.7 KB

Sessions

Get current concurrency status

Returns the organization's concurrent-session limit, an approximate count of sessions currently in use, whether a new session can likely be started, and an estimated wait time until a slot frees. Intended as an advisory pre-check before starting a session (e.g. to gate a "Start" button or show a wait estimate). The count is the Lab's optimistic view and can briefly over-report; the authoritative limit is enforced when a session is actually created, which may still return 429.

get/v1/sessions/concurrency

Query parameters

organizationIdstring

Report the concurrency status of another organization. Restricted to Anam-internal admin API keys; other keys receive 403.

Response

Current concurrency status for the organization

limitinteger

The organization's concurrent-session plan limit.

activeinteger

Approximate number of sessions currently occupying a slot.

canStartSessionboolean

Advisory — whether a session can likely be started now.

estimatedWaitSecondsinteger nullable

Estimated seconds until the next slot frees while at capacity (derived from the org's rolling 30-day average session length and the elapsed time of the longest-running session); 0 when a slot is available or expected imminently; null when no estimate is possible.

Example response

{
  "limit": 10,
  "active": 7,
  "canStartSession": true
}