📡 Status: Preview Only
AYDA’s Phase 2 API introduces sandboxed inference endpoints, persona‑driven logic, and modular access controls. All functionality is subject to change during the preview period.
🔧 Endpoint Overview
| Endpoint | Method | Description | Status |
|---|---|---|---|
/v2/infer |
POST | Run inference using a selected persona | Preview |
/chat |
POST | Stream persona‑driven responses in real time | Preview |
/v2/persona/switch |
POST | Switch active persona during a session | Preview |
/v2/persona/list |
GET | Retrieve available personas | Stable |
/v2/session/trace |
GET | Fetch session metadata for audit and review | Preview |
/v2/license/validate |
POST | Validate access permissions | Planned |
🧠 Persona Switching Logic
AYDA supports dynamic persona switching through the /persona/switch endpoint. Additional routing behavior and enrichment logic are documented under NDA.
🧪 Inference Preview
The /infer endpoint accepts structured requests with persona context and returns high‑level inference results. Detailed traceability features are available under NDA.
💬 Streaming Chat Interface
AYDA’s /chat endpoint enables real‑time persona‑driven conversations using Server‑Sent Events (SSE). This interface is optimized for chatbot UIs, SOC dashboards, and interactive workflows.
Content-Type: application/json
Response: text/event-stream
Optional headers and persona overrides are available under NDA.
📦 Python Streaming Client (httpx)
Client examples and advanced usage are available under NDA.
⚠️ Notes & Limitations
- All endpoints are sandboxed and rate‑limited
- Persona switching is non‑persistent unless explicitly tagged
- Air‑gapped deployments support offline upgrades and version pinning
🔖 AYDA API Documentation — Public Preview
Last updated: August 2025 · Endpoint structure and behavior may evolve during the preview period.
Additional roadmap details and enrichment logic are available through NDA‑bound materials.

