Unified API Reference¶
Last Updated: 2026-07-17 This document provides an overview of the unified API structure after the StartupOS migration. Access rules for StartupOS routes live in access-control.md.
Base URL¶
All API routes are prefixed with /api/. The production base URL is https://www.archetiq.com/api/.
Authentication¶
- Method: JSON Web Token (JWT)
- Header:
Authorization: Bearer <token> - Expiry: 30 days
- Key Endpoints:
/api/auth/register,/api/auth/login
API Endpoints¶
Personality-Test Endpoints¶
| Prefix | Description |
|---|---|
/api/users |
User profile management. |
/api/responses |
Assessment submission and results. |
/api/ai |
AI-powered insights and chat (Gemini & Ollama). |
/api/organisations |
Corporate and Institution account management. |
/api/teams |
Team management for organisations. |
/api/coaches |
Coach profile and tool endpoints. |
/api/stripe |
Payment and subscription handling. |
| (... and other existing endpoints) |
Migrated StartupOS Endpoints¶
| Prefix | Description | Access |
|---|---|---|
/api/startups |
CRUD operations for startups, workspace progress tracking. | StartupOS / founder / admin / org-scope |
/api/startup-v2 |
Retired after ARCH cutover. Legacy data is migrated through POST /api/startup-arch/migrate. |
Deprecated |
/api/sprints |
Sprint and task management for a startup's agile board. | StartupOS / founder / admin / org-scope |
/api/cohorts |
Create and manage university cohorts. | Institution Admin/Lecturer |
/api/lecturer |
Endpoints for the Lecturer Dashboard to view assigned teams. | Institution Lecturer |
/api/decision-lab |
Endpoints for the Decision Intelligence Lab simulations. | StartupOS / founder / admin / org-scope |