headyapi.com · Powered by Heady™

Complete API Reference
for the Heady Platform

REST · JSON-RPC · WebSocket · SSE · OpenAPI 3.0 spec

Get API Key →
OpenAPI SpecSDK LibrariesRate LimitsWebhooksAuth Tokens
Health & Status
GET /api/health (service health + Redis pool), GET /api/pulse (full system status), GET /health/live (K8s liveness), GET /health/ready (readiness).
Intelligence
GET /api/nodes (AI node status), GET /api/system/status (full system), GET /api/monte-carlo/simulate (MC planning), GET /api/patterns (recognized patterns).
Registry
GET /api/registry (full component registry), GET /api/registry/ai-nodes (20-node topology), GET /api/registry/environments (deploy targets).
Rate Limits
Anonymous: 34 req/min (FIB[8]). Authenticated: 89 req/min (FIB[10]). Enterprise: 233 req/min (FIB[12]). Auth endpoints: stricter limits.

Heady™ Ecosystem

11 domains, one intelligence layer. Sign in once, access everything.

HS
headysystems.com
Corporate hub
HM
headyme.com
Personal AI profiles
HB
headybuddy.com
AI companion portal
MC
headymcp.com
MCP tools
IO
headyio.com
Service integrations
BT
headybot.com
Bot/agent listings
HL
headylens.com
Visual AI tools
AI
headyai.com
Research papers
HF
headyfinance.com
Financial tools
HC
headyconnection.org
Non-profit arm