Documentation

API Reference

Overview of the main Velamini API capabilities.

Last updated: March 10, 2026

Authentication

Authenticate requests with your API key using the X-Agent-Key header.

Keep secrets server-side and rotate keys immediately when exposure is suspected.

Core endpoints

Use POST /api/agent/chat, GET /api/agent/sessions, GET /api/agent/history, and POST /api/agent/feedback.

The React hook pattern in the docs uses these endpoints directly for custom chat widgets.

Rate limits and errors

Use retry logic with exponential backoff for temporary failures.

Handle validation and authentication errors explicitly in your integration code.