Skip to main content
GET
Get Stats

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

X-Namespace
string
header
required

Namespace id (ns_...), not the namespace name. This scopes the request rather than authenticating it, and it is required on every operation marked x-mixpeek-namespace-scoped.

Path Parameters

retriever_id
string
required

Response

Successful Response

Aggregate statistics for a retriever's learned fusion system.

total_learners
integer
required

Total number of unique users with learned weights.

avg_interactions_per_user
number
required

Average number of interactions per user.

weight_spread
number
required

Maximum divergence of any feature weight from uniform.

context_level_distribution
Context Level Distribution · object
required

Count of users at each context level (personal/demographic/global).

enabled
boolean
required

Whether learned fusion is currently enabled for this retriever.

rollout_pct
number
required

Effective percentage of traffic receiving learned fusion weights (a live override takes precedence over the configured value).

shadow_mode
boolean
required

Whether learned fusion is running in shadow mode (logging only).

active_learners
integer
default:0

Unique users the system is actively learning for (alias of total_learners — backs the Studio Overview 'Active Learners' card).

context_hit_rate
number
default:0

Fraction of learners that have reached a personalized (non-global) context — enough interactions for personal weights (0-1).

rollout_override
boolean
default:false

Whether a live rollout override is active (vs the config value).

config_rollout_pct
number
default:100

The retriever's configured rollout_pct (ignoring any live override).

source
string | null

Which store served the weights: 'signals' (the namespace's _signals collection) or 'clickhouse' (analytics fallback).

warning
string | null

Set when the response contains fallback defaults due to an internal error.

hint
string | null

Set when learned fusion is NOT configured for this retriever — the payload is a well-formed empty state and this explains how to enable learning.