Total Human DesignDocs|Changelog

Changelog

Updates to the THD API and Developer Portal.

New Endpoint
Breaking Change
Bug Fix
Improvement
Deprecation
Portal Update
Feature
Content
Announcement

June 2026

v2.2.0PortalJune 23, 2026
  • Console V2 — playground, proxy, "what can I call", in-console password reset
  • Checkout embedded on billing cards — no redirect
  • Stack up to 3 subscriptions per product, or switch — with confirmation
  • Cancel any subscription in-app, per plan
  • Usage page shows Chart and SAGE meters against your tier limits
  • Usage arcs go green/amber/red by remaining quota
  • API keys labeled by tier access
  • Refreshed developer API pricing page — monthly and annual
  • MCP server at full API parity — 14 tools incl. query_sage, get_penta
  • BaZi / Four Pillars now a first-class SAGE domain + /api/bazi/chart.svg
  • Every API key gets a Free floor — ≥100 chart / 25 SAGE calls
  • Stacked plans enforced as the sum of active subscriptions

April 2026

v2.1.0APIApril 11, 2026
  • Search cities with the new /api/locations endpoint
  • Clean URL aliases /api/locations and /api/validate-location available
  • Fix location search and validate-location returning wrong suggestions
v2.1.0PortalApril 11, 2026
  • What's New bell shows release announcements in the portal
  • Try location and validate-location API calls directly in the docs
  • City Search docs page added to the Location API section
  • Terminal-style demo replaces form in API request examples
v2.0.0PortalApril 9, 2026
  • MCP server docs: quickstart, tools reference, resources reference
  • Advanced Monthly subscription tier added
  • Validate-location endpoint documented
  • What's New bell and public changelog page
v2.0.0APIApril 8, 2026
  • /api/eclipses for solar/lunar eclipse computation
  • /api/v1/validate-location with offline 68k-city GeoNames resolution
  • apiKey query param accepted when load balancer strips headers
  • Offline-only location — Google Maps dependency removed

March 2026

v1.7.0APIMarch 20, 2026
  • Clean URL routes: /api/chart, /api/astrology, /api/sage, and more
  • /api/returns for planetary return charts
  • /api/multi-chart batch endpoint — up to 10 charts in parallel
  • MCP server mounted at /mcp
v1.6.0APIMarch 16, 2026
  • Astrology plain language endpoint with 14 composers and 9 synthesizers
  • Astrology chart enrichment: dignities, chart shape, mutual receptions, dispositor chain
v1.4.0PortalMarch 15, 2026
  • Docs restructured from monolithic JSX to modular MDX pages
  • Basic tier removed from available plans
v1.5.0APIMarch 8, 2026
  • /api/transit-periods with hybrid scan for gate-change timestamps
  • /api/retrograde-periods with minute-precision station dates
  • lat/lon accepted as alternative to birthLocation on all endpoints

February 2026

v1.4.0APIFebruary 22, 2026
  • HD plain language chart translation endpoint
  • Minute-granularity ephemeris with gzip compression for transits
v1.3.0PortalFebruary 20, 2026
  • Payment channels split: Whop recurring, Nas.io one-time
v1.2.0PortalFebruary 7, 2026
  • API docs synced to actual live endpoints: v1/v2/v3 chart, composite, astrology
  • Removed insecure default-secret fallback in API key hashing
v1.1.0PortalFebruary 6, 2026
  • Usage tracking now counts units consumed, not just requests
  • Quota warning at 80% and 100% of monthly limit
  • Transit API documented: params, granularity, unit billing
  • Human Design AI API product added to billing
v1.3.0APIFebruary 5, 2026
  • /api/v2/transit-chart with daily, hourly, and minute granularity
  • Dev portal API key validation with HMAC-SHA256 hashing
  • Redis-backed rate limiting with concurrent request tracking
  • /api/sage/query endpoint for AI knowledge queries (5 units/query)
v1.0.0PortalFebruary 5, 2026
  • Developer portal launched: API key management, billing, usage dashboard
  • Whop checkout integration for subscription plans
  • Usage dashboard with per-request logs: endpoint, status, response time
  • Rate Limits docs with real per-tier concurrent limits

January 2026

v1.2.0APIJanuary 14, 2026
  • Western astrology extras: Chiron, Part of Fortune, aspect orbs
  • Design date included in chart responses
  • Tone calculation fix for Motivation 5

December 2025

v1.1.0APIDecember 22, 2025
  • V2 endpoints with organized response structure
  • Composite endpoint with camelCase parameter schema
  • Moon transit range endpoint
v1.0.0APIDecember 5, 2025
  • Human Design chart calculation via Swiss Ephemeris (Personality + Design)
  • V1/V2/V3 chart endpoints with Colors, Tones, Variable, PHS data
  • Composite (relationship) chart endpoint
  • Western astrology endpoint with houses, angles, and aspects
  • Incarnation cross, strategy, signature, and profile in chart output