Search Knowledge Base

Perform vector similarity search across one or more knowledge bases. Supports semantic search via query text, tag-based filtering, or a combination of both.

POST/api/v1/knowledge/search
X-API-Key<token>

Your SteelEngine API key (personal or workspace). Generate one from the SteelEngine dashboard under Settings > API Keys.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/knowledge/search" \  -H "Content-Type: application/json" \  -d '{    "workspaceId": "wsp_abc123",    "knowledgeBaseIds": [      "kb_abc123"    ],    "query": "How do I reset my password?",    "topK": 5  }'
{  "success": true,  "data": {    "results": [      {        "documentId": "doc_abc123",        "documentName": "Getting Started.pdf",        "content": "To reset your password, go to Settings > Security.",        "chunkIndex": 3,        "similarity": 0.95,        "metadata": {}      }    ],    "query": "How do I reset my password?",    "knowledgeBaseIds": [      "kb_abc123"    ],    "topK": 5,    "totalResults": 1  }}