UDT Mark 2 API
v1.0 (udt-m2v1) — Organism-tier cognitive architecture
The Universal Digital Twin (UDT) is an AI-powered platform that creates intelligent digital representations of people, processes, and knowledge. Use this API to build conversational interfaces, manage knowledge, orchestrate workflows, and surface insights — all through a single integration.
Authentication
Three authentication methods are supported. Choose based on your environment.
🔑 API Key
For server-to-server integrations
X-API-Key: <your-api-key> # Or via Authorization header: Authorization: ApiKey <your-api-key>
🔐 OIDC Bearer
For user-facing applications
Authorization: Bearer <jwt-token> # Obtain via /auth/oidc/config
🧪 Dev Bypass
For local development only
# Set environment variable: AUTH_BYPASS=true # No auth headers needed
http://localhost:3200Quick Start
Get up and running in minutes. Four essential workflows to integrate UDT.
1. Health Check
Verify twin health and service status
curl http://localhost:3200/api/health
2. Get Twin Status
Get twin identity and uptime
curl http://localhost:3200/api/status
3. Send Chat Message
Send a message to the twin
curl -X POST http://localhost:3200/api/v1/chat/chat/message \
-H "Content-Type: application/json" \
-d '{"text": "Hello twin!", "userId": "user-123"}'4. Get Organism Status
View cognitive state and tangle index
curl http://localhost:3200/api/v1/organism/status
Use Cases
Explore UDT capabilities organized by business value.
Health Monitoring
Check twin health and service status
3 endpointsConversational Intelligence
Chat interface for twin interaction
3 endpointsOrganism Tier
Cognitive state, tangle index, and sleep cycles
3 endpointsContinuity & Lifecycle
Twin lifecycle management and succession
1 endpointsHierarchy
Ancestry chains and projection policies
1 endpointsCommons & Welfare
Pattern library and twin welfare
3 endpointsIngestion
Source ingestion and processing
1 endpoints