Download OpenAPI specification:
Local knowledge base REST API
{- "command": "status",
- "config": {
- "documents_dir": "string",
- "data_dir": "string",
- "chat_model": "string",
- "embedding_model": "string",
- "vision_model": "",
- "reranker_model": "",
- "enable_ocr": true
}, - "sources": [
- {
- "filename": "string",
- "file_hash": "string",
- "chunk_count": 0,
- "ingested_at": "string"
}
], - "total_chunks": 0
}[- {
- "source": "string",
- "content_type": "string",
- "excerpts": [
- {
- "content": "string",
- "page_start": 0,
- "page_end": 0,
- "line_start": 0,
- "line_end": 0,
- "relevance": 0
}
], - "best_relevance": 0,
- "vault_path": "string"
}
]| question required | string |
| top_k | integer <= 100 Default: 0 |
object or null | |
string or null |
{- "question": "string",
- "top_k": 0,
- "options": {
- "property1": null,
- "property2": null
}, - "chunk_type": "string"
}{- "answer": "string",
- "sources": [
- {
- "source": "string",
- "content_type": "string",
- "chunk": "string",
- "distance": 0,
- "relevance_score": 0,
- "page_start": 0,
- "page_end": 0,
- "line_start": 0,
- "line_end": 0,
- "chunk_index": 0,
- "vault_path": "string"
}
]
}| question required | string |
| top_k | integer <= 100 Default: 0 |
object or null | |
string or null |
{- "question": "string",
- "top_k": 0,
- "options": {
- "property1": null,
- "property2": null
}, - "chunk_type": "string"
}null| question required | string |
| history | any Default: [] |
| top_k | integer <= 100 Default: 0 |
object or null | |
string or null |
{- "question": "string",
- "history": [ ],
- "top_k": 0,
- "options": {
- "property1": null,
- "property2": null
}, - "chunk_type": "string"
}{- "answer": "string",
- "sources": [
- {
- "source": "string",
- "content_type": "string",
- "chunk": "string",
- "distance": 0,
- "relevance_score": 0,
- "page_start": 0,
- "page_end": 0,
- "line_start": 0,
- "line_end": 0,
- "chunk_index": 0,
- "vault_path": "string"
}
]
}| question required | string |
| history | any Default: [] |
| top_k | integer <= 100 Default: 0 |
object or null | |
string or null |
{- "question": "string",
- "history": [ ],
- "top_k": 0,
- "options": {
- "property1": null,
- "property2": null
}, - "chunk_type": "string"
}null| paths required | Array of strings |
| force | boolean Default: false |
boolean or null | |
number or null |
{- "paths": [
- "string"
], - "force": false,
- "enable_ocr": true,
- "ocr_timeout": 0
}null{- "chat": {
- "active": "string",
- "catalog": [
- {
- "name": "string",
- "size_gb": 0,
- "min_ram_gb": 0,
- "description": "string",
- "installed": true
}
], - "installed": [
- "string"
]
}, - "embedding": {
- "active": "string",
- "catalog": [
- {
- "name": "string",
- "size_gb": 0,
- "min_ram_gb": 0,
- "description": "string",
- "installed": true
}
], - "installed": [
- "string"
]
}, - "vision": {
- "active": "string",
- "catalog": [
- {
- "name": "string",
- "size_gb": 0,
- "min_ram_gb": 0,
- "description": "string",
- "installed": true
}
], - "installed": [
- "string"
]
}, - "reranker": {
- "active": "string",
- "catalog": [
- {
- "name": "string",
- "size_gb": 0,
- "min_ram_gb": 0,
- "description": "string",
- "installed": true
}
], - "installed": [
- "string"
]
}
}string or null | |
| search | string Default: "" |
string or null | |
boolean or null | |
| sort | string Default: "featured" |
| limit | integer <= 1000 Default: 20 |
| offset | integer >= 0 Default: 0 |
{- "total": 0,
- "limit": 0,
- "offset": 0,
- "models": [
- {
- "hf_repo": "string",
- "gguf_filename": "string",
- "task": "string",
- "display_name": "string",
- "param_count": "string",
- "size_gb": 0,
- "min_ram_gb": 0,
- "description": "string",
- "quality_tier": "string",
- "featured": true,
- "downloads": 0,
- "installed": true,
- "source": "string"
}
], - "has_more": false
}| search | string Default: "" |
| limit | integer <= 1000 Default: 50 |
| offset | integer >= 0 Default: 0 |
{- "documents": [
- {
- "filename": "string",
- "chunk_count": 0,
- "ingested_at": ""
}
], - "total": 0,
- "limit": 0,
- "offset": 0,
- "has_more": false
}| names required | Array of strings <= 100 items |
| delete_files | boolean Default: false |
{- "names": [
- "string"
], - "delete_files": false
}{- "removed": [
- "string"
], - "not_found": [
- "string"
]
}[- {
- "wiki_source": "",
- "wiki_chunk_index": 0,
- "citation_key": "",
- "claim_type": "fact",
- "source_filename": "",
- "source_hash": "",
- "page_start": 0,
- "page_end": 0,
- "line_start": 0,
- "line_end": 0,
- "excerpt": "",
- "created_at": ""
}
]