Documentation

Everything you need to integrate and build with KAAL.

Authentication

All API requests must be authenticated using a Bearer token in the Authorization header.

Authorization: Bearer chrn_...

Ingest Event

Feed unstructured text to your agent's memory. KAAL automatically extracts the relationships, entities, and temporal data.

POST/ingest

curl -X POST https://your-api.hf.space/ingest \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "my-app",
    "events": [{"text": "Acme Corp signed a new $50k contract today"}]
  }'

Query Memory

Search your agent's memory using natural language. Returns fully structured JSON objects representing the events.

POST/query

curl -X POST https://your-api.hf.space/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What did Acme Corp do?"}'