Search file content via RAG/KAG and return scored snippets

Scored-chunk content search across the user’s eligible IP Vault (personal + current institution + account-shared siblings). Returns ~200-char snippets centered on matched tokens, with a relevance score per chunk and a rag | kag | fused source label. Confidential institution files surface a 🔒 placeholder snippet rather than raw chunk text. selectedUploadIds is optional — when provided, it intersects with the user’s scope; foreign or malformed ids are silently dropped (never 403). Rate-limited per user (default 20/min).

POST /api/user/files/search-content

Search file content via RAG/KAG and return scored snippets

cURL

curl --request POST \
  --url https://pria.praxislxp.com/api/user/files/search-content \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "query": "quantum gravity",
  "selectedUploadIds": [
    "<string>"
  ],
  "minScore": 0.1,
  "limit": 50
}
'

200

{
  "success": true,
  "query": "quantum gravity",
  "results": [
    {
      "uploadId": "<string>",
      "chunkId": "<string>",
      "chunkIndex": 123,
      "snippet": "<string>",
      "score": 123,
      "upload": {
        "_id": "<string>",
        "originalname": "<string>",
        "filesize": 123,
        "mimetype": "<string>",
        "file_title": "<string>",
        "institution": "<string>",
        "is_private": true,
        "confidential": true
      }
    }
  ],
  "totalScanned": 123,
  "uploadCount": 123,
  "tookMs": 123
}

Authorizations

x-access-token · string · header · required

JWT token passed in x-access-token header

Body

application/json

query · string · required

The search query string.

Maximum string length: 500

Example:

"quantum gravity"

selectedUploadIds · string[] | null

Optional whitelist of upload ids. Intersected with the user's eligible scope; foreign / malformed ids are silently dropped.

Maximum array length: 5000

minScore · number<float> · default: 0.1

Minimum dense (vector) score floor. Ignored for KAG-fused results.

Required range: 0 <= x <= 1

limit · integer · default: 50

Maximum number of results to return.

Required range: 1 <= x <= 100

Response

200

application/json

Content-search results

success · boolean

Example:

true

query · string

Example:

"quantum gravity"

results · object[]

Show child attributes

totalScanned · integer

Number of raw results returned by searchRag before the minScore filter.

uploadCount · integer

Number of distinct uploads in the user's searchable scope.

tookMs · integer

Server-side elapsed time in milliseconds.