Typeahead
Prefix suggestions for a search box (autocomplete/typeahead).
Suggests from three namespace-scoped sources concurrently: values of the
requested metadata fields (index-backed, with per-value document counts),
collection names, and the caller’s own recent search queries. A source
that cannot answer is dropped and named in warnings rather than
failing the request.
Authorizations
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.
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.
Query Parameters
The typed prefix.
1 - 200Comma-separated metadata field paths to suggest values from (e.g. metadata.talent,metadata.production). Each field should carry a keyword index; at most 5 are consulted. Omit to skip the field-value source.
Max suggestions per source.
1 <= x <= 50Response
Successful Response
Prefix suggestions for a search box (UF-15).
Three sources, each scoped to the caller's namespace and organization:
metadata-field values (index-backed facet, prefix-filtered), collection
names, and the caller's own recent search queries. suggestions is the
flat ranked convenience list (recent searches first, then field values by
count, then collection names, case-insensitively deduplicated). A source
that fails or times out is dropped and named in warnings instead of
failing the request.
The prefix that was matched.
Flat ranked suggestion texts across all sources.
Field-value suggestions with per-value document counts.
Collections whose name matches the prefix.
The caller's own recent queries matching the prefix, newest first.
Sources that could not be consulted this request.

