Chat

Search chats

Hybrid search across the caller's chat history that merges two lanes: a case-insensitive title-substring match and a semantic (vector) match over each chat's AI-generated summary. Title matches are returned first (a strong signal the user remembers the chat name), followed by semantic matches in relevance order, de-duplicated and capped at limit.

Authorization: User-scoped keys (u:gcai_...) search the chats that user can access. Organization-scoped keys search every chat shared with the entire organization, regardless of who or what created it. Chats that remain private to an individual user are never returned to an org-scoped key.

API-created chats appear here only once they've been materialized; unmaterialized chats are not in anyone's history and won't match.

get/chat/search

Request

Query parameters

qstring required

Search query (required, 1-500 chars). Natural language is fine.

Example:force majeure carve-out
limitinteger

Max chats to return (default 20, max 50)

Response

Chats matching the query

soft_threshold_fallbackboolean required

True when no semantic match cleared the relevance cutoff and the response includes the closest below-threshold candidates instead of omitting them.

Changes

No recorded changes to this operation across all 1 revision of this API.