Skip to main content
POST
/
v1
/
knowledgebases
/
query
Query knowledge bases
curl --request POST \
  --url http://co-mind-platform-host/v1/knowledgebases/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "knowledgebase_ids": [
    "kb_abc123",
    "kb_def456"
  ],
  "query": "How does gradient descent work?",
  "limit": 5,
  "min_score": 0.7
}
'
{
  "object": "knowledgebase.query.result",
  "query": "How does gradient descent work?",
  "results": [
    {
      "knowledgebase_id": "<string>",
      "document_id": "<string>",
      "title": "<string>",
      "content": "<string>",
      "relevance_score": 123,
      "page": 123,
      "link": "<string>"
    }
  ],
  "total_results": 123
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Supports two token types:

  • JWT Access Token — obtained via POST /v1/auth/login
  • Personal Access Token (PAT) — created via POST /v1/api-tokens, format: cmnd_<tokenId>.<secret>

Body

application/json
​
knowledgebase_ids
string[]
required

List of knowledge base IDs to query

Example:
["kb_abc123", "kb_def456"]
​
query
string
required

The query text

Example:

"How does gradient descent work?"

​
limit
integer
default:5

Maximum number of results to return

​
min_score
number
default:0.7

Minimum relevance score (0-1)

Response

Query results

​
object
string
Example:

"knowledgebase.query.result"

​
query
string
Example:

"How does gradient descent work?"

​
results
object[]
​
total_results
integer