Skip to content

Knora API

The institutional memory platform for teams that can't afford to forget. Capture, structure, and query everything your organization knows.

Get Started | Authentication


API Reference

Authentication & Users

Endpoint Description
Auth JWT tokens, register, login, Google OAuth, member management
Organizations Org profile, plan changes, resource limits

Knowledge Base

Endpoint Description
Knowledge Entry CRUD, versioning, tags, departments, bulk import/export
Query & Search RAG-powered Q&A, semantic search, gap detection
Knowledge Graph Auto-linked knowledge graph, clusters

Capture

Endpoint Description
Voice Audio upload, Whisper transcription, async processing
Documents PDF, Word, Excel upload, OCR, structured parsing
Manual Entry Direct text entry creation
Interviews Templates, sessions, answers, shift logs

Integrations & Analytics

Endpoint Description
Integrations Slack, Gmail, GitHub, Notion, Google Drive connectors
Analytics Bus factor scoring, staleness detection
Dashboard Management overview, activity feed, trending queries
Billing Stripe checkout, subscription management
External API API keys, outbound webhooks

Quick Start

# 1. Login
curl -X POST https://your-instance.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "password": "..."}'

# Response: {"access_token": "eyJ...", "user": {...}}
# 2. Ask a question
curl https://your-instance.com/api/v1/query/ask \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"query_text": "What is our onboarding process?"}'
# 3. Create a knowledge entry
curl -X POST https://your-instance.com/api/v1/knowledge/ \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"title": "Onboarding Guide", "content": "Step 1: ..."}'

Authentication

All endpoints require a JWT access token via Authorization: Bearer <token>, except:

  • POST /auth/register — Create account
  • POST /auth/login — Get tokens
  • POST /auth/google — Google OAuth sign-in
  • GET /health — Liveness probe

See the Auth docs for full details.