Introduction

The Humaner API gives you access to Humaner backend, agents, memory and handoff framework. Share a base URL, authentication scheme and response format described jsut below.

Features

Chat

Stream agent replies over SSE.

Agents

Fetch agent metadata & config.

Handoff

Create Desk tickets from your UI.

Proactive popup

Push a teaser + badge to a live widget.

Base URL

https://app.humaner.io

Endpoints

Method	Path	Purpose
POST	/api/v1/chat	Send a message, stream the reply (Humaner)
POST	/api/v1/intelligence/retrieve	Search knowledge (Custom + Humaner, API key)
POST	/api/v1/intelligence/create-ticket	Open a Human Desk ticket (Custom + Humaner)
POST	/api/v1/intelligence	Invoke any Intelligence tool by name
GET	/api/v1/agents/{publicId}	Fetch agent name, character, greeting
POST	/api/v1/visitors/identify	Attach a visitor ID for cross-session memory
POST	/api/v1/handoff/ticket	Create a the desk ticket for handoff
POST	/api/v1/widget/proactive	Queue a popup teaser for an identified visitor

Authentication

Every endpoint takes the same Bearer API key you created.

Authorization header

Authorization: Bearer hm_live_xxxxxxxx

Response conventions

Endpoint	Response type
POST /api/v1/chat	text/event-stream (SSE). See the Chat reference
All others	application/json

Errors are always { "error": "message" }. Full table detailed on Errors page.

Plan gating

API access needs Custom or Humaner.