KOSMOS V2.0 API Reference

Complete REST API documentation for KOSMOS V2.0.

API Overview

Base URL

Production: https://api.nuvanta-holding.com/v2
Development: http://localhost:8000/api/v2

Authentication

All API endpoints require authentication via JWT tokens:

curl -X POST https://api.nuvanta-holding.com/v2/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "..."}'

Response:

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "token_type": "bearer",
  "expires_in": 3600
}

Include the token in subsequent requests:

curl https://api.nuvanta-holding.com/v2/agents \
  -H "Authorization: Bearer eyJ..."

API Categories

Category	Endpoints	Description
Authentication	/auth/*	Login, logout, token refresh
Agents	/agents/*	Agent invocation and status
Tasks	/tasks/*	Task management and history
MCP	/mcp/*	MCP server interactions
Users	/users/*	User management
Tenants	/tenants/*	Multi-tenant operations

WebSocket API

Real-time updates via WebSocket:

const ws = new WebSocket('wss://api.nuvanta-holding.com/v2/ws');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Event:', data.type, data.payload);
};

Rate Limiting

Tier	Requests/min	Burst
Free	60	10
Pro	600	100
Enterprise	Unlimited	1000

API Documentation

Auto-Generated from FastAPI

This API documentation is automatically generated from FastAPI's OpenAPI specification. Endpoints, schemas, and examples are extracted directly from the codebase.

Browse by category:

• Authentication
• Reference