API Docs

Reference for every endpoint.

Auto-generated from the same Zod schemas the API enforces at runtime — what you read here is what the engine accepts. Click an endpoint to see the request body, response shape, and a runnable curl example.

Swagger UI loads from https://dashboard.astronode.dev/docs — served by the public REST API itself, generated from the same Zod schemas the engine validates against. If the iframe fails to load, open it directly in a new tab.

What's in the docs

Auth & rate limits

Bearer-token auth with aie_test_* / aie_live_* key prefixes. Per-plan rate limits + idempotency.

Request envelope

Same shape across every tradition: a small birth-input + an optional interpretation block for narrative endpoints.

Response envelope

Every response returns request_id, data, an optional interpretation, and meta with engine version + computed_at.

AI Astrologer (chat)

POST /v1/chat/respond takes a conversation_id, a birth input, and a message — returns a tone-labelled reply plus structured practices. Same Bearer key, same plan limits.