Knowledge RAG

Ingest documents into local RAG index

post/api/knowledge-rag/ingest

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/knowledge-rag/ingest
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

collectionstring
documentsobject[] required
chunkingobject
metadataobject
tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "collection": "tenant:stadtwerk-a:knowledge",
  "documents": [
    {
      "text": "§21a EnWG ..."
    }
  ],
  "chunking": {
    "mode": "paragraph"
  },
  "metadata": {
    "source": "internal-policy"
  }
}

Response

Job accepted and queued for async processing

successboolean
jobIdstring
status'queued'
messagestring
statusUrlstring
resultUrlstring

Example response

{
  "success": true,
  "jobId": "6fd38b12-a3f4-41d5-8f49-e7f9c1b2d3e4",
  "status": "queued",
  "message": "Job started. Poll /api/jobs/:jobId/status for progress.",
  "statusUrl": "/api/jobs/6fd38b12-a3f4-41d5-8f49-e7f9c1b2d3e4/status",
  "resultUrl": "/api/jobs/6fd38b12-a3f4-41d5-8f49-e7f9c1b2d3e4/result"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.