Skip to content

AGENTS.md

Latest commit

 

History

History
83 lines (72 loc) · 5.33 KB

AGENTS.md

File metadata and controls

83 lines (72 loc) · 5.33 KB
Raw

AGENTS.md for Human Design API

This repo teaches AI coding agents (Cursor, Claude Code, Aider, Codex, Windsurf, RooCode, Gemini CLI) how to use the RoxyAPI Human Design bodygraph endpoint.

Endpoint

  • Method: POST
  • URL: https://roxyapi.com/api/v2/human-design/bodygraph
  • Auth: X-API-Key header
  • Domain: human-design (one of 12 in the RoxyAPI catalog)
  • Operation ID: generateBodygraph matches the SDK method name in camelCase
  • MCP tool: post_human_design_bodygraph on https://roxyapi.com/mcp/human-design

TypeScript SDK

import { createRoxy } from '@roxyapi/sdk';
const roxy = createRoxy(process.env.ROXY_API_KEY!);
const { data, error } = await roxy.humanDesign.generateBodygraph({
  body: {
    date: '1990-07-15',
    time: '13:00:00',
    timezone: 'America/New_York',
  },
});

Python SDK

import os
from roxy_sdk import create_roxy
roxy = create_roxy(os.environ["ROXY_API_KEY"])
result = roxy.human_design.generate_bodygraph(
    date="1990-07-15",
    time="13:00:00",
    timezone="America/New_York",
)

Setup step (none required)

The bodygraph depends only on ecliptic longitudes at the birth instant, so there is no /location/search setup step. latitude and longitude are optional, default to 0, and do not affect the chart. Send date, time, and timezone only.

Request fields

  • date (string, required): birth date YYYY-MM-DD. The anchor for both the Personality activations at birth and the Design activations 88 degrees of solar arc earlier
  • time (string, required): birth time HH:MM:SS, 24-hour. Precision matters: profile lines and gate boundaries shift with the exact minute of birth
  • timezone (number or IANA string, required): UTC offset (e.g. -5) or IANA name (e.g. "America/New_York", "Asia/Kolkata"). Server resolves DST-correct offset for the birth date
  • latitude (number, optional): -90 to 90, defaults to 0. Does not affect the bodygraph
  • longitude (number, optional): -180 to 180, defaults to 0. Does not affect the bodygraph

Response top level keys

  • type: energy type. One of Manifestor, Generator, Manifesting Generator, Projector, Reflector
  • strategy: the aura strategy for engaging life correctly for this type
  • authority: inner authority for decision making. One of Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, Lunar
  • signature: the signature feeling of living in alignment with the type
  • notSelf: the not-self theme that signals being out of alignment
  • profile: conscious/unconscious form (e.g. "3/5") from the Personality Sun line over the Design Sun line
  • definition: one of None, Single, Split, Triple Split, Quadruple Split, from connected components among defined centers
  • incarnationCross: gates[4] (Personality Sun, Personality Earth, Design Sun, Design Earth), angle (Right Angle, Juxtaposition, Left Angle), angleCode (RAX, JXT, LAX), name
  • centers[]: 9 entries with id (head, ajna, throat, g, heart, sacral, solar-plexus, spleen, root), name, defined, motor, awareness, theme, gates[]
  • channels[]: only the defined channels, each with gateA, gateB, name, circuit (Individual, Collective, Tribal), centers[]
  • gates[]: all 26 activations, 13 personality and 13 design. Each has planet, side, gate (1-64), line (1-6), gateName, ichingHexagram (number, english)

Domain rules

  • No location step. Unlike the chart endpoints in other domains, the bodygraph ignores coordinates. Never ask the user for a birth city unless you want it for display.
  • timezone accepts both decimal UTC offset and IANA name. IANA strings resolve to the DST-correct offset for the birth date, so a summer birth and a winter birth in the same city get different offsets automatically.
  • Birth time precision matters. A few minutes can shift a gate or a profile line. Never round or default the time silently.
  • The Design side is solved on the exact 88 degree solar arc before birth, not approximated as 88 calendar days.
  • authority is resolved by strict priority: Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, Lunar. The first defined source wins.
  • Each gate maps one-to-one to an I-Ching hexagram by number, a factual correspondence used to enrich activations.
  • The activating bodies are Sun, Earth, Moon, North Node, South Node, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, on each side.
  • For type-only features use POST /human-design/type, a strict subset that skips the full payload. For two people use POST /human-design/connection. For current sky overlays use POST /human-design/transit.
  • Every endpoint accepts an optional lang query param (en, de, es, fr, hi, pt, ru, tr).

Related endpoints

  • POST /human-design/type (calculateType): type, strategy, authority, signature, not-self theme, and profile without the full bodygraph payload
  • POST /human-design/connection (calculateConnection): two-person connection chart, every channel classified electromagnetic, dominance, compromise, or companionship
  • POST /human-design/profile (calculateProfile): the profile with both Sun lines and a keynote for each

Verified

2026-Q3 against https://roxyapi.com/api/v2/openapi.json. Re-fetch the spec for ground truth before changing this file.

Discovery