Technical
Knowledge
A streamlined upload and source management area for adding material into the default workspace corpus.
Public and internal interfaces
These are the main routes, handlers, and integration surfaces used by this product area.
GET /api/portal/corpus/corpora
POST /api/portal/rag/upload
POST /api/portal/rag/ingest-text
GET /api/portal/dms/categories
Architecture notes
- Knowledge is a thin page over shared upload and corpus components.
- Uploads use multipart /api/portal/rag/upload and persist into the DMS helpers.
- Saved text is chunked and indexed through /api/portal/rag/ingest-text.
Access and permissions
App pages are authenticated through the shared bnl_session cookie unless explicitly marked public. Public docs should describe integration behavior without including secrets, private tokens, private IPs, or tenant-specific records.
Troubleshooting
- Editor or higher role is required for most write actions.
- Parser failures usually appear as document status error in Corpus.