API Documentation

Ragionex provides two products through a single REST API: Knowledge for semantic search over documentation, and Memory for persistent semantic memory for AI agents. Both products share the same base URL and use JSON for requests and responses.

Base URL

All API requests are made to:

Authentication

All API endpoints require authentication via the X-API-Key header. The two products use different API key types:

Knowledge API

Uses a shared API key provided during Developer Preview. The key prefix is rgx_knowledge_demo_. Grab the key from the Knowledge page.

Memory API

Uses per-user API keys generated at first sign-in. The key prefix is rgx_memory_. Sign in at app.ragionex.com/login to receive your key.

X-API-Key: rgx_memory_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API Products

Pick the product you're integrating to see its full endpoint reference:

Error Handling

All API errors return a consistent JSON format with success: false and an error message describing the issue.

{
  "success": false,
  "error": "Description of what went wrong"
}

HTTP Status Codes

Common Errors

{
  "success": false,
  "error": "Invalid or missing API key"
}

{
  "success": false,
  "error": "Invalid or missing API key. Get your key by signing in at https://app.ragionex.com/login"
}

{
  "success": false,
  "error": "question parameter is too long (max 128 characters)"
}

{
  "success": false,
  "error": "Rate limit exceeded"
}

Rate Limits

Rate limits are applied per IP address. When you exceed the limit, the API returns a 429 status code.

Knowledge API Limits

Memory API Limits