Overview

Learn how to use the Helvia.ai API

The Helvia Agents 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.

Services

Service	Description
hbf-bot	Runs agent configurations in real-time chat channels (Web, Viber, Messenger, Slack, Teams).
hbf-doc-ingestion	Ingests documents (PDF, DOCX, PPTX, HTML, MD, TXT), converts them 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