Step 7

Backend-Ready API Contract

Full schema is available in contracts/openapi.yaml and contracts/agent-orchestration.json. This page shows a quick extract of the endpoint surface.

openapi: 3.1.0
info:
  title: GitaVerse API
  version: 1.0.0
paths:
  /v1/verses/search:
    post:
      summary: Search verses by theme and context
  /v1/ai/explain:
    post:
      summary: Explain verse with citations
  /v1/agents/run:
    post:
      summary: Run orchestrated multi-agent workflow
  /v1/journey/recommend:
    post:
      summary: Personalized learning path recommendation

Operational Principles

• All AI responses include source citation and confidence level.
• Sensitive prompts trigger safety policy and mentor escalation guidance.
• Agent orchestration logs every sub-step for traceability and debugging.
• Localization contracts support Hindi, English, and regional extensions.