v4

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-13216144508.7 KB

Set Collection Rerank Model

Bind or clear the rerank model for a collection.

When set, knowledge_search adds a rerank stage for this KB using the configured model. When cleared, no rerank is performed.

The rerank binding is user-scoped and stored in collection_config, so different users can have different rerank settings for the same collection name.

patch/api/kb/collections/{collection}/rerank-model

Path parameters

collectionstring required

Request body

rerank_model_idstring nullable

Rerank model ID registered in the model hub. Pass null or an empty string to clear the binding (search will no longer rerank for this collection).

Response

Successful Response

statusstring required

Operation status: success|partial_success|error

collectionstring required

Collection identifier affected by the operation

messagestring required

Human-readable summary of the collection operation

warningsstring[]

Non-fatal issues encountered while processing the collection

deleted_countsobject

Aggregated deletion counts per table when applicable