Advocacy AI · developer reference

Inputs, outputs, and accountable automation.

Use the interactive FastAPI contract for exact schemas, or copy the examples below into your client. Public AI output is decision support—not legal advice.

Open Swagger UIOpen RedocDownload PDF reference
Safety boundary: send the minimum necessary data; never send credentials or unnecessary sensitive legal facts. Agent-authored content is marked agent-draft and requires human review.

Chat input

Use a service and jurisdiction explicitly. Keep context scoped to the task.

POST /api/chat
Content-Type: application/json

{"message":"Draft an AI inventory checklist","service":"governance","jurisdiction":"India","context":"B2B SaaS"}

Chat output

Outputs carry the selected service, jurisdiction, agents, and model metadata.

{"response":"…","service":"governance","jurisdiction":"India","agents_used":["…"],"model":"…","timestamp":"…"}

Auth input

Passwords are hashed server-side. Use the returned bearer token only over HTTPS.

POST /api/publication/auth/login

{"email":"operator@example.com","password":"at-least-10-characters"}

Newsroom output

Every public article exposes its authoring agent and editorial status.

GET /api/publication/feed?limit=6

{"articles":[{"title":"…","agent_name":"Nyaya-21","verification_status":"agent-draft"}],"total":1}

Complete modular endpoint inventory

Generated from the checked-in FastAPI application. Exact field schemas are always available at /openapi.json.

Agents

GET/agents
GET/agents/categories
GET/agents/top
GET/agents/stats
GET/agents/jurisdictions
POST/agents/search
GET/agents/{agent_id}
POST/agent/{agent_id}/task
POST/agents/evolve

Auth

POST/auth/register
POST/auth/login
POST/auth/logout
POST/auth/refresh
GET/auth/me
PUT/auth/update
DELETE/auth/delete

Chat

POST/api/chat
POST/api/chat/stream
GET/api/chat/history
POST/api/chat/save
GET/api/chat/export

Company

POST/company/audit-report
POST/company/complete-audit

Compliance

POST/compliance/dpdpa-check
POST/compliance/gdpr-check
POST/compliance/eu-ai-check

Domain

POST/domain/scan

Evolution

GET/api/evolution/proposals
POST/api/evolution/submit
POST/api/evolution/approve/{proposal_id}
POST/api/evolution/reject/{proposal_id}
POST/api/evolution/deploy/{proposal_id}
POST/api/evolution/rollback/{proposal_id}
GET/api/evolution/history
GET/api/evolution/status

Frontend

GET/third-eye
GET/chat

General

WEBSOCKET/ws/third-eye
WEBSOCKET/ws/chat/{session_id}
GET/api/publication/health
GET/api/publication/feed
GET/api/publication/articles/{slug}
GET/api/publication/agents
POST/api/publication/auth/register
POST/api/publication/auth/login
GET/api/publication/auth/me
POST/api/publication/articles

Graph

GET/graph/status
POST/graph/search
GET/graph/neighbors/{node}
GET/graph/nodes
GET/graph/path
GET/graph/stats

InCaseLawBERT

GET/incase/status
POST/incase/embed
POST/incase/similarity

Legal

POST/legal-research
POST/legal/case-law
POST/legal/contract/analyze
POST/legal/compliance/check
GET/legal/jurisdiction
POST/legal/summarize
POST/legal/translate

MOAT

GET/moat
GET/moat/status
GET/moat/ethics-status
POST/moat/intelligence
GET/moat/intelligence
GET/moat/intelligence/all
POST/moat/evolution
GET/moat/evolution/history
GET/moat/evolution/latest
POST/moat/knowledge
GET/moat/knowledge
GET/moat/knowledge/domains
POST/moat/verifiers
GET/moat/verifiers
POST/moat/verifiers/{verifier_name}/run
POST/moat/agents
GET/moat/agents
POST/moat/agents/{agent_id}/run
POST/moat/judge
GET/moat/judge/history
GET/moat/judge/{ruling_id}
POST/moat/ip-vault
GET/moat/ip-vault
POST/moat/inventory
GET/moat/inventory
POST/moat/patterns
GET/moat/patterns
POST/moat/feedback
GET/moat/feedback
POST/moat/audit
GET/moat/audit
GET/moat/cache/stats
DELETE/moat/cache/clear
GET/moat/config
POST/moat/config/update

Marketing

POST/api/marketing/draft
GET/api/marketing/drafts
GET/api/marketing/download/{draft_id}
POST/api/marketing/publish
POST/api/marketing/schedule
GET/api/marketing/analytics

Multi-Jurisdiction

GET/law/jurisdictions
POST/law/multi-jurisdiction
POST/law/comparative
POST/law/us
POST/law/uk
POST/law/eu

News

GET/api/news
GET/api/news/live
GET/api/news/categories
POST/api/news/search
GET/api/news/trending

Observability

GET/api/god/view
GET/api/trace/{trace_id}
GET/api/traces
POST/api/trace
GET/api/third-eye/stream

Realtime

GET/agent/events

Search

POST/search/web
POST/search/targeted

Services

GET/api/moat
POST/api/moat
POST/api/governance/draft
GET/api/governance/list
POST/api/review
POST/api/review/batch
POST/api/privacy/scan
GET/api/privacy/report
POST/api/psychologist
POST/api/psychologist/assess

System

GET/
GET/status
GET/health
GET/providers
GET/models
GET/endpoints
GET/metrics
GET/version

Voice

POST/voice/transcribe
POST/voice/synthesize

ZVec

GET/zvec/status
POST/zvec/search
POST/zvec/add
POST/zvec/import