Search evidence

Semantic search across the team's evidence. Returns scored, attributed quotes matching a natural-language query.

POST/v1/evidence/search

Example

curl -X POST "https://silent-viper-157.convex.site/v1/evidence/search" \  -H "Authorization: Bearer $ASKENGINE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "query": "confusion setting up API keys",    "signalId": "sig_123",    "limit": 10  }'

Request Body

querystring

Natural-language search query - a focused question, or a pasted quote or complaint to match against.

signalId?string

Scope hits to one signal's evidence basis.

studyId?string

Restrict the search to one study.

kind?string

Valuesevidence, counterEvidenceDefaultevidence

limit?integer

Maximum number of hits to return.

Default10Range1-50

minScore?number

Drop hits scoring below this threshold.

Range0-1

Response

{  "data": [    {      "item": {        "evidenceId": "ev_001",        "kind": "evidence",        "quote": "I gave up twice before I figured out where to add my API key.",        "themeId": "thm_setup",        "themeLabel": "Setup friction",        "studyId": "study_789",        "studyName": "Onboarding interviews Q4",        "sourceItemId": "src_a1",        "participantName": "Ada L.",        "timeInCallSecs": 412,        "capturedAt": 1764453600000      },      "score": 0.83    }  ]}