Get Session Facets
Return per-dimension facet counts for sessions the caller can see.
Labels follow SES-LBL-060/061; agents / models / users
are first-class dimensions off the same filter set so the popover
can render one request’s worth of options for every dropdown.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Organization slug
Organization slug
Workspace slug
Workspace slug
Query Parameters
Section titled “Query Parameters ”Filter by one or more project IDs (repeatable, OR combine). See SES-LST-006.
Scope facets to active / archived / any.
Scope facets to active / archived / any.
Match the list endpoint’s workload-session default (SES-LST-009). Pass true to facet across workload origins too.
Match the list endpoint’s workload-session default (SES-LST-009). Pass true to facet across workload origins too.
Responses
Section titled “ Responses ”Successful Response
Per-dimension value counts for sessions matching the caller’s filter.
labels mirrors SES-LBL-061: keys with no matching sessions are
omitted. agents / models / users carry the three
first-class columns that aren’t labels but drive the same popover
filter surface — each list is already sorted by count DESC with a
stable alphabetical tiebreaker.
object
Distinct session.agent values with session counts. Sessions with a null agent are excluded.
A single value and its count within a label key facet bucket.
object
Per-key label value counts; empty keys are omitted.
object
A single value and its count within a label key facet bucket.
object
Distinct session.model values with session counts.
A single value and its count within a label key facet bucket.
object
Distinct session.origin values with session counts. Values are the SES-ORG-001 enum (user, worker, eval, optimization, training, world).
A single value and its count within a label key facet bucket.
object
Distinct session owners (sessions.user_id) with counts.
A single user and the session count attributed to them.
Carries enough denormalized identity to render the filter chip without
a follow-up request (same shape used by SessionCreatorResponse).
Invalid request
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Authentication failed
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Access forbidden
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Not found
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Already exists
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Validation error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Upgrade required
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Rate limited
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Internal server error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Bad gateway
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Gateway timeout
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type