Adhoc Retrievers3

Agent Sessions11

Alerts16

Analytics42

Annotations7

Apps34

Batches4

Bucket Batches23

Bucket Objects10

Bucket Syncs15

Bucket Uploads7

Buckets7

BYO Documents5

Cluster Executions7

Cluster Triggers8

Clusters10

Collection Documents17

Collection Lifecycle2

Collection Schema1

Collection Taxonomies1

Collections10

Custom Models8

Data Subject Access Requests3

Discovery4

Document Lineage3

Documents6

Events1

Extractor Publishing5

Extractors5

Feature Extractors2

Feature Search1

Features1

Health4

Inference1

Manifest7

Marketplace14

Models6

Namespace Clone1

Namespace Extractors2

Namespace Migrations7

Namespace Snapshots6

Namespaces10

Notifications13

Onboarding2

Organization API Keys5

Organization Audit4

Organization Billing22

Organization Connections8

Organization Infrastructure1

Organization Secrets4

Organization Targets1

Organization Usage3

Organization Users5

Organizations4

Pricing1

Public Apps API5

Public Extractor Marketplace2

Public Notifications API1

Public Retriever API7

Public Templates API8

Published Retrievers8

Quickstart1

Resource Search1

Retriever API Keys3

Retriever Benchmarks4

Retriever Evaluations8

Retriever Interactions5

Retriever Learned Fusion10

Retriever Stages1

Retrievers14

Scaffold Templates3

Source Adapter1

Support14

Tasks3

Taxonomies13

Taxonomy Analytics6

Templates24

Triggers10

Webhooks5

Retriever Learned Fusion

Get Stats

Get aggregate statistics for a retriever's learned fusion system.

get/v1/retrievers/{retriever_id}/learned-fusion/stats

Path parameters

retriever_idstring required

Response

Successful Response

total_learnersinteger required

Total number of unique users with learned weights.

active_learnersinteger

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

avg_interactions_per_usernumber required

Average number of interactions per user.

weight_spreadnumber required

Maximum divergence of any feature weight from uniform.

context_level_distributionobject required

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

context_hit_ratenumber

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

enabledboolean required

Whether learned fusion is currently enabled for this retriever.

rollout_pctnumber required

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

rollout_overrideboolean

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

config_rollout_pctnumber

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

shadow_modeboolean required

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

warningstring nullable

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

hintstring nullable

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 (BACKE-2525).