Skip to content

Product API Reference

Each product has its own API. Full interactive documentation is available at /docs on each product (development mode only).

Quick Reference

Product Base URL Key Endpoints
Document Search :8100 POST /api/v1/documents/upload, POST /api/v1/search/query, DELETE /api/v1/documents/{id}
FAQ Chatbot :8101 POST /api/v1/chat/message, POST /api/v1/knowledge/faq, POST /api/v1/knowledge/upload
Email Triage :8102 POST /api/v1/triage, POST /api/v1/triage/batch
CRM Follow-ups :8103 POST /api/v1/draft, POST /api/v1/draft/batch
Meeting Actions :8104 POST /api/v1/extract
Invoice Processor :8105 POST /api/v1/process
Social Media :8106 POST /api/v1/generate
Scheduling :8107 POST /api/v1/parse, POST /api/v1/parse/batch

Admin Endpoints (all products)

Available on products with persistent storage (Document Search, FAQ Chatbot):

Endpoint Method Role Description
/api/v1/admin/audit GET Admin View audit logs
/api/v1/admin/gdpr/export/{user_id} GET Admin GDPR data export
/api/v1/admin/gdpr/delete/{user_id} DELETE Admin GDPR data deletion
/api/v1/admin/storage GET Admin Storage usage stats

OpenAPI / Swagger

In development mode (HAAGSMAN_ENVIRONMENT=development), each product serves interactive API documentation:

  • Swagger UI: http://localhost:{port}/docs
  • ReDoc: http://localhost:{port}/redoc

These are disabled in production for security.

Rate Limits

Default: 60 requests per minute per API key / user.

Rate limit headers are included in responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1712582400

Pagination

Audit log endpoint supports pagination:

GET /api/v1/admin/audit?limit=50&offset=100

Support

For API integration help: niels@haagsman.ai