Developer Reference

API Documentation

REST API for the YUYAY Intelligence Framework. Base URL: https://yuyay-production-2e45.up.railway.app

Open Swagger UIOpen ReDoc

Authentication

Protected endpoints require a JWT token obtained from POST /api/v1/auth/login. Submit credentials as multipart/form-data and include the returned token as:

Authorization: Bearer <your_access_token>
Endpoints
GET/api/v1/health

Health check. Returns API status and version.

{ "status": "ok", "version": "0.1.0" }
GET/api/v1/archetypes/

Returns all twelve archetypes with name, function, gifts, and shadow dimensions.

[{ "name": "...", "function": "...", "gifts": "...", "shadow": "..." }, ...]
GET/api/v1/transformers/

Returns all transformer questions used in the evaluation questionnaire.

[{ "id": "1a", "question": "..." }, ...]
POST/api/v1/auth/login

Authenticates a user and returns a JWT access token. Send as multipart/form-data.

{ "access_token": "<jwt>", "token_type": "bearer" }
POST/api/v1/evaluateAuth Required

Processes a set of YES/NO/PO responses and returns counts, flags, and a summary. Send as JSON with an Authorization: Bearer <token> header.

{ "session_id": "...", "yes_count": 7, "no_count": 1, "po_count": 2, "total": 10, "flags": ["3b"], "summary": "..." }
POST/api/v1/compareAuth Required

Queries multiple LLM providers concurrently with the same prompt and scores each response for YUYAY coherence.

{ "prompt": "...", "results": [...], "best_provider": "openai" }
Interactive Console

Live Swagger UI, try any endpoint directly in the browser.