Authentication

All requests to the Kai Affective Intelligence API require a Bearer token. Your API key is issued per organisation at onboarding.

Base URL

https://api.togetherwithkai.com/v1/affective

Include your API key in the Authorization header of every request:

Authorization: Bearer YOUR_API_KEY

Store your API key securely in your platform’s keystore. Never expose it in client-side code or public repositories.

The API has six endpoints in two groups:

Group	Endpoints	Purpose
Ingestion	`POST /ingest/batch`, `POST /ingest/stream`, `GET /ingest/status`	Receive content from your platform and feed Kai Brain
Output	`GET /pulse`, `GET /alerts`, `POST /configure`	Return aggregated signals to your dashboard or plugin

curl -X GET "https://api.togetherwithkai.com/v1/affective/pulse?window=30d&layers=all" \
  -H "Authorization: Bearer YOUR_API_KEY"

Admin-only endpoints (POST /configure) require an API key with admin role permissions.