Welcome To Headoni

Guides and API reference for the Headoni support platform.

Headoni is a multi-tenant customer support platform. Each desk is a full support instance with its own tickets, departments, agents, and end users. This site documents the public API you can call from your own services.

The API is per-desk. You mint a bearer token on your desk's API page, then call the desk's tenant host. Use it to file tickets from forms, monitors, and internal tools, and to read those tickets back.

Mint a token and make your first call.

File a ticket on behalf of an end user.

Fetch one ticket or list them with filters.

Look up department and ticket type ids.

Where Requests Go#

Every API request goes to your desk's built-in tenant host. A desk at the slug acme is reached at https://acme.headoni.app. Custom domains are supported for the customer-facing portal, but the API host is always the .headoni.app tenant URL.

Machine-Readable Reference#

Every page on this site ships a plain-text LLM twin, and the whole tree is indexed at https://docs.headoni.com/llms.txt (or grab it all at once at /llms-full.txt). An agent can start at the index and reach every page through the /llms endpoints alone. See For LLMs & agents for the details, or use the "LLM doc" button at the bottom of any API page.

Separately, every live desk publishes its own llms.txt at https://<your-desk>.headoni.app/llms.txt: the same reference, pre-filled with that desk's departments, ticket types, and defaults. Hand that URL to an agent so it can file tickets against a specific desk without copy-pasting ids.