Check Knowledge Base Status

Monitor processing status and health of a knowledge base during background ingestion.

string

required

The knowledge base ID

curl -X GET https://api.artaios.ai/api/v1/knowledge-bases/kb_123/check_status/ \
  -H "x-api-key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://api.artaios.ai/api/v1/knowledge-bases/kb_123/check_status/",
    headers={"x-api-key": "YOUR_API_KEY"}
)
result = response.json()

const response = await fetch('https://api.artaios.ai/api/v1/knowledge-bases/kb_123/check_status/', {
  headers: {
    'x-api-key': 'YOUR_API_KEY'
  }
});
const result = await response.json();

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

pending

Knowledge base created but processing not started

running

Collections are being processed and indexed

completed

All collections processed successfully

failed

Processing failed - check error details

Use this endpoint to poll for status updates during background ingestion. The processing_metadata field provides detailed progress information.

Delete Knowledge Base Available Collections

API Overview

Agents

Sessions

Runtime

Files

Collections

Knowledge Bases

Images

Response

Status Values

​Response

​Status Values

Response

Status Values