API Reference

Complete endpoint documentation with examples in curl, Python, and TypeScript.

Authentication

Pragmara uses two authentication methods:

  • JWT (Bearer Token): Used for dashboard operations (managing KBs, documents, API keys). Obtained via magic link login.
  • API Key (X-Pragmara-Key header): Used for querying Knowledge Bases. Scoped to a specific KB. Rate limited to 100 req/min.
Header format
Authorization: Bearer <jwt_token>    # For dashboard endpoints
X-Pragmara-Key: <api_key>             # For query endpoint