Zurvan REST API & Gateway Overview
The VynTech Zurvan API follows the modular standalone microservice pattern established across VynTech ID and VynTech Account, while fully supporting centralized deployment behind the VynTech Unified API Gateway.
VynTech Cloud API Base: https://zurvan.apis.vyntech.com.au/api/v1 • Self-Hosted Default: http://localhost:8080/api/v1
All authenticated endpoints require a valid JWT token in the Authorization: Bearer <token> header.
Dual Architecture Model
┌────────────────────────────────────────────────────────┐
│ VynTech Ecosystem │
└──────────────────────────┬─────────────────────────────┘
│
┌───────────────────┴───────────────────┐
▼ ▼
┌──────────────────────────────┐ ┌──────────────────────────────┐
│ Decoupled / Standalone │ │ Unified Platform Gateway │
│ Microservice │ │ (zurvan.apis.vyntech.com.au)│
│ │ │ │
│ • Independent Go REST API │ │ • Central API Gateway │
│ • Local SQLite / Postgres │ │ • VynTech ID & SSO Sync │
│ • Embedded Scalar & Swagger │ │ • Unified Billing & Access │
│ • Custom Ports & DB URLs │ │ • Multi-App Synergy │
└──────────────────────────────┘ └──────────────────────────────┘Health & Diagnostics Probes
Service Health & Uptime
Returns service health, version, database engine type, and system uptime.
Status Codes
- Name
200- Type
- HTTP
- Description
- Service is operational.
Readiness Probe with DB Check
Kubernetes readiness probe verifying active database connection pool health and migration state.
Status Codes
- Name
200- Type
- HTTP
- Description
- System is ready to accept traffic.
- Name
503- Type
- HTTP
- Description
- Database is unavailable or migrations running.
API Modules Directory
Authentication & SSO
Local registration, login, and VynTech ID single sign-on synchronization.
Organizations & Members
Multi-tenant organization workspaces, RBAC membership, and context switching.
Strategic Horizons (3-Tier)
Long-term (6M), mid-term (3M), and short-term (1M) goal tree management.
Tasks & Daily Timeline
Focus minutes budgeting, Must/Should/Could execution, and 1-click rollover.