Skip to main content
POST
Set Rollout

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

Body

application/json

Live traffic-split override for learned fusion (no config edit).

rollout_pct
number
required

Percent of traffic that uses learned weights (0-100). 100 clears the override so the retriever's configured rollout_pct applies again.

Required range: 0 <= x <= 100

Response

Successful Response

The response is of type Response Set Rollout V1 Retrievers Retriever Id Learned Fusion Rollout Post · object.