HireAlpha Developers

HireAlpha exposes a small, public, unauthenticated API for product metadata, plus an auth-gated per-user API that powers the web app and the iMessage bots. This portal covers the public surface and how to integrate responsibly.

Quickstart

curl https://hirealpha.chat/api/public/info
curl https://hirealpha.chat/api/public/personas
curl -X POST https://hirealpha.chat/api/waitlist \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com"}'

Machine-readable everything

/openapi.json — the OpenAPI 3 spec for the public API.
/llms.txt — when-to-use guidance for agents.
/sitemap.xml — indexable URLs.
Every HTML page answers Accept: text/markdown with markdown.

Endpoints

Method	Path	Auth	Purpose
GET	/healthz	none	Liveness probe.
GET	/api/public/info	none	Product metadata and resource links.
GET	/api/public/personas	none	The three personas and what they do.
POST	/api/waitlist	none	Join the waitlist.

Rate limits and sandbox

The public API is rate-limited to 60 requests per minute per IP. There is no separate sandbox today; the public endpoints are read-only and safe to call directly. The per-user API (calendar, mail, body, actions) requires a user's own session token and is intentionally not available to third parties — if you are building an integration, use the public surface and direct users to connect their own accounts.

See the full reference at /docs. Questions: partners@hirealpha.chat.