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
| Mode | Use when |
|---|---|
keyword | Exact phrase, names, ids |
semantic | Conceptual queries, natural language |
hybrid | Default. 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
| Code | HTTP | Meaning |
|---|---|---|
query_too_long | 400 | Max 1,024 characters |
invalid_type | 400 | Unknown node type |