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.
Request
- Base URLhttps://app.gc.ai/api/external/v1
- AuthAPI key in header Authorization
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Search query (required, 1-500 chars). Natural language is fine.
Max chats to return (default 20, max 50)
Response
Chats matching the query
Changes
No recorded changes to this operation across all 1 revision of this API.