Search and Knowledge Graph

Use POST /api/v1/search for keyword, semantic, or hybrid search.

{
  "query": "permission model",
  "mode": "hybrid",
  "workspace_ids": ["workspace_uuid"],
  "limit": 20
}

Search results are filtered through the caller's effective resource access. A workspace id in a request is an upper bound, not an authorization grant.

Use mode: "keyword" for exact names and identifiers, semantic for concepts, and hybrid for general knowledge retrieval. For AI agents, cite resource ids and titles returned by search so answers remain inspectable.