Skip to main content
POST
/
api
/
user
/
files
/
search-content
Search file content via RAG/KAG and return scored snippets
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
}
'
{
  "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
}

Documentation Index

Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Content-search results

success
boolean
Example:

true

query
string
Example:

"quantum gravity"

results
object[]
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.