Overview

Learn how to use the Helvia API

The Helvia.ai Platform exposes REST APIs through multiple services. Each service handles a specific domain of the platform's functionality.

Not all API services are listed here yet. This section is actively maintained — check back later for additional services.

Services

Service	Description
hbf-bot	Chatbot executor — runs agent configurations in real-time chat channels (Web, Viber, Messenger, Slack, Teams). No OpenAPI spec.
hbf-doc-ingestion	Document processing — ingests documents (PDF, DOCX, PPTX, HTML, MD, TXT), converts to Markdown, segments into semantic chunks, and optionally tags via LLMs.

Common Patterns

All API services follow these conventions:

• Content-Type: application/json for request and response bodies

• Error responses: Standard HTTP status codes with JSON error bodies

• CORS: Enabled for all origins in local development