Skip to main content
GET
/
v1
/
knowledge
/
query
Search knowledge
curl --request GET \
  --url https://api.seynlabs.com/v1/knowledge/query \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "results": [
      {
        "ruleId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "description": "<string>",
        "processId": "<string>",
        "processName": "<string>",
        "step": "<string>",
        "confidence": 123,
        "score": 123
      }
    ],
    "explain": {
      "strategy": "<string>",
      "sqlHitCount": 123,
      "bm25HitCount": 123,
      "vectorHitCount": 123,
      "graphTraversalDepth": 123,
      "rerankerUsed": "<string>",
      "latencyMs": 123
    }
  },
  "meta": {
    "requestId": "<string>",
    "total": 123,
    "strategy": "<string>"
  }
}
Runs your question through the full hybrid query pipeline: structured, full-text, and semantic signals fused, reranked, and graph-expanded over the active knowledge library. Returns ranked rule hits. Leave strategy at its default (auto) unless you have a reason to force one. Pass include=explain to get per-result signal attribution, the same data the dashboard’s Query Explorer shows.

Authorizations

​
Authorization
string
header
required

Bearer token from app.seynlabs.com → Settings → API Keys. Send as Authorization: Bearer sk_live_....

Query Parameters

​
q
string
required

The natural-language query.

Minimum string length: 1
​
strategy
enum<string>

Retrieval strategy. Defaults to auto (the analyzer picks).

Available options:
auto,
structured,
hybrid,
graph
​
topK
integer
default:10

Maximum number of hits to return (1–50). Defaults to 10.

Required range: 1 <= x <= 50
​
libraryId
string<uuid>

Restrict search to a specific knowledge library.

​
include
string

Comma-separated list of optional fields to include. Currently only explain is supported.

Response

Search results.

​
success
enum<boolean>
required
Available options:
true
​
data
object
required
​
meta
object
required