Knowledge Base
Upload documents and query knowledge for agents
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /knowledge-base/ | List all documents |
| POST | /knowledge-base/ | Upload a new document (multipart) |
| GET | /knowledge-base/{id} | Get document metadata |
| PATCH | /knowledge-base/{id} | Update name or metadata |
| DELETE | /knowledge-base/{id} | Archive (soft delete) |
| POST | /knowledge-base/{id}/unarchive | Restore an archived document |
Upload a Document
POST
/knowledge-base/Content-Type: multipart/form-data
Form Fields
| Parameter | Type | Required | Description |
|---|---|---|---|
file | file | Required | The document file |
name | string | Optional | Display name.Default: filename |
Supported formats: PDF, DOCX, TXT, MD, HTML, CSV
bash
curl -X POST https://api.sysevo.io/api/v1/knowledge-base/ \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/document.pdf" \
-F "name=Product FAQ"Document Status Values
| Status | Meaning |
|---|---|
processing | Being chunked and embedded (typically < 60s) |
ready | Indexed and available for agents |
failed | Processing failed — check file format |
archived | Soft-deleted — not available to agents |
Assigning Documents to Agents
After upload, assign documents to an agent via the visual builder or by including their IDs in the agent node document_refs field. Via MCP, get IDs with list_documents then reference them in the node config.
Was this page helpful?
Open Dashboard →