Skip to main content
POST
/
api
/
v1
/
rag
/
query
Query Knowledge Base
curl --request POST \
  --url https://api.ravan.ai/api/v1/rag/query \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "org_id": "<string>",
  "kb_id": "<string>",
  "query": "<string>"
}
'
{
  "success": true,
  "message": "<string>",
  "data": {
    "results": [
      {
        "text": "<string>",
        "score": 123,
        "doc_id": "<string>",
        "metadata": {}
      }
    ]
  }
}

​
Authorizations

​
X-Api-Key
string
required
Your Agni API key used to authenticate the request. Pass it in the X-Api-Key header. Find or rotate it from your Ravan AI account settings.

​
Body

​
org_id
string
required
The organization ID that owns the resource. Use the organization ID from your Agni account.
​
kb_id
string
required
The unique knowledge base ID. Use the ID returned by the knowledge base create or list endpoint.
​
query
string
required
The natural-language question or search query to run against the knowledge base.

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
Human-readable status message.
​
data
object
Returned data.

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
org_id
string
required

Organization ID

​
kb_id
string
required

Knowledge Base ID

​
query
string
required

Search query

Response

200 - application/json

Successful response

​
success
boolean
​
message
string
​
data
object