Skip to main content
GET
Get Weights

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

Global weight distribution for a retriever's learned fusion.

feature_weights
Feature Weights · object
required

Per-feature weight distribution keyed by feature_uri.

total_interactions
integer
required

Total number of interactions across all features.

learner_count
integer
required

Number of unique users with personal-level weights.

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.