Skip to main content
Monitor processing status and health of a knowledge base during background ingestion.
kb_id
string
required
The knowledge base ID
curl -X GET https://api-be.atthene.com/api/v1/knowledge-bases/kb_123/check_status/ \
  -H "x-api-key: YOUR_API_KEY"

Response

Returns a success wrapper with the full knowledge base object:
{
  "success": true,
  "message": "Status checked for knowledge base 'Product Knowledge Base'",
  "knowledge_base": {
    "id": "kb_123",
    "name": "Product Knowledge Base",
    "status": "running",
    "progress": 45,
    "processing_engine": "milvus",
    "datasource_count": 15,
    "total_datasources": 15,
    "success_rate": 0,
    "ingested_datasources": [],
    "failed_datasources": [],
    "processing_metadata": {
      "phase": "batch_embedding",
      "total_chunks": 1250,
      "processed_chunks": 562,
      "message": "Generating Embeddings: 562/1,250 chunks"
    },
    "updated_at": "2025-01-15T10:35:00Z"
  },
  "status_updated": true
}

Status Values

Knowledge base created but processing not started
Collections are being processed and indexed
All collections processed successfully
Processing failed - check error details
Use this endpoint to poll for status updates during background ingestion. The processing_metadata field provides detailed progress information.