Skip to main content

API Overview

Audience: Developer
Page Type: Reference

Base URL​

https://api.cos-platform.com/v1

Authentication​

All requests require JWT token in header:

Authorization: Bearer {jwt_token}
X-Tenant-ID: {tenant_id}
Content-Type: application/json

Main Endpoints​

Auth​

POST   /auth/login
POST   /auth/register
POST   /auth/refresh-token

Platform & Admin​

GET/POST/PATCH   /users                     # User management
GET/POST         /users/me/onboarding       # Onboarding
GET/POST/PATCH   /tenants                   # Tenant management
GET/POST/PATCH   /admin/tenants             # Admin tenant management
GET/POST/PATCH   /tenant-groups             # TenantGroup (holding) management
GET/POST/PATCH   /admin/users               # Admin user management
GET/POST         /admin/permissions          # RBAC permission management
GET              /admin/dashboard            # Admin dashboard
GET/POST         /admin/library              # Admin library management
GET              /admin                      # Admin lookups
GET/POST         /permissions                # Permission checks
GET              /lookups                    # General lookups
GET/POST         /notifications              # Notification system

Plans & Subscriptions​

GET/POST/PATCH/DELETE  /plans                # Plan CRUD
GET/PUT                /plans/overrides      # Feature overrides
GET/POST/PATCH/DELETE  /subscriptions        # Subscription CRUD

Context​

GET/POST/PATCH   /org                       # Organization structure
GET/POST/PATCH   /products                  # Product management
GET/POST/PATCH   /mission-vision            # Mission & Vision
GET/POST/PATCH   /strategic-cycles          # Strategic cycles

Analysis​

GET/POST/PATCH   /current-states            # Current State Analysis
GET/POST/PATCH   /product-scorecard         # Product Scorecard
GET/POST/PATCH   /digital-maturity          # Digital Maturity Assessment
GET/POST/PATCH   /admin/digital-maturity-templates  # DMA Templates
GET/POST/PATCH   /excellence-assessments    # Excellence Assessment
GET/POST/PATCH   /admin/excellence-templates # Excellence Templates
GET/POST/PATCH   /resources-vrio            # VRIO Resource Analysis
GET/POST/PATCH   /pestle                    # PESTLE Analysis
GET/POST/PATCH   /porter-5                  # Porter Five Forces Analysis
GET/POST/PATCH   /bcg-matrix                # BCG Matrix
GET/POST/PATCH   /findings                  # Findings

Synthesis​

GET/POST/PATCH   /swot                      # SWOT Analysis
GET/POST/PATCH   /strategic-themes          # Strategic Themes

Execution​

GET/POST/PATCH   /bsc                       # Balanced Scorecard
GET/POST/PATCH   /new-okr                   # OKR Management
GET/POST/PATCH   /performance-indicator     # Performance Indicators (KPI)
GET/POST/PATCH   /roadmap                   # Strategy Roadmap

Gap Analysis & Reporting​

GET/POST/PATCH   /gaps                      # Gap management
GET/POST/PATCH   /gaps/actions              # Gap actions
GET              /reports/performance        # Performance reports
GET              /strategy-dashboard         # Strategy dashboard
GET              /dashboard                  # General dashboard
GET              /team/performance           # Team performance

Library​

GET/POST/PATCH   /kpi-library               # KPI library
GET/POST         /integrations              # Integrations

AI​

POST   /ai-assistant                        # AI chat
GET    /admin/ai                            # AI admin management

Rate Limiting​

100 requests per minute (per user)

Error Responses​

400 Bad Request
401 Unauthorized (JWT invalid)
403 Forbidden (Permission denied)
404 Not Found
500 Internal Server Error

Documentation​

Full API docs: [Not yet published in codebase]

See also​