Docs/API/Search

Search API.

One ranked answer across every node the caller is allowed to see. Hybrid keyword and semantic. Permission-aware. Cited.

Endpoint

One endpoint:

POST /v1/search

Query

curl -X POST https://api.wrxstack.com/v1/search   -H "Authorization: Bearer $WRX_API_KEY"   -H "Content-Type: application/json"   -d '{
    "q": "Acme MSA renewal terms",
    "types": ["Document","Contract","Meeting"],
    "limit": 10,
    "mode":  "hybrid"
  }'
{
  "data": [
    {
      "id": "doc_01HQ3K...",
      "type": "Document",
      "title": "Acme MSA v3 (in negotiation)",
      "score": 0.94,
      "snippet": "…the renewal terms shall extend the agreement for an additional 24 months…",
      "url": "https://docs.acme.wrxstack.com/d/doc_01HQ3K..."
    }
  ],
  "total": 14
}

Modes

ModeUse when
keywordExact phrase, names, ids
semanticConceptual queries, natural language
hybridDefault. The best of both, ranked.

Permissions

Search never returns a node the caller can't read. There is no "blurred result" with a "request access" affordance; the result is simply absent. This is deliberate: leaking the existence of a node is itself a leak.

Errors

CodeHTTPMeaning
query_too_long400Max 1,024 characters
invalid_type400Unknown node type