Vedic v2

Hosted Vedic Chat (v2)

Hosted Vedic Chat orchestration.

This endpoint uses FreeAstroAPI's scoped Vedic MCP tools for deterministic chart facts, then generates a concise answer through the hosted model layer. Developers who bring their own model should use /mcp/vedic-bot directly.

post/api/v2/vedic/chat

Request

  • Base URL: https://api.freeastroapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.freeastroapi.com/api/v2/vedic/chat
  • Auth: none declared

Headers

x-api-keystring nullable
Idempotency-Keystring nullable

Optional client-generated operation key for safe retries. Reuse it only with the exact same request for up to 24 hours. A replay does not consume another hosted chat message.

Request body

messagestring required

User's Vedic astrology question.

conversation_idstring nullable

Stable thread id for remembered context.

memory'thread' | 'request'

thread stores recent turns; request is stateless.

localestring

Preferred answer locale.

tone'clear' | 'gentle' | 'technical'

Answer tone.

reference_datestring date nullable

Optional local reference date for daily, dasha, or gochar questions.

debugboolean

Include tool trace for development.

Response

Hosted Vedic Chat response. An idempotent replay returns the original response.

replystring required
conversation_idstring required
needs_birth_databoolean required
required_profile'primary' | 'partner' nullable
required_fieldsstring[] nullable
used_toolsstring[] required
latency_msinteger required
modelstring nullable
tool_traceobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.