> For the complete documentation index, see [llms.txt](https://docs.helvia.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helvia.ai/api/overview.md).

# 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.

{% hint style="warning" %}
Not all API services are listed here yet. This section is actively maintained.
{% endhint %}

### 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