API Reference

Open API

RESTful endpoints for projects, activities, analytics, and AI services.

Authentication

All endpoints require Azure AD Bearer token authentication.

Authorization: Bearer {access_token}

# Base URL
Production: https://api.konnectxd.com/v1
Development: http://localhost:8000

Projects

GET/api/projects

List all projects

Response

[
  {
    "id": 1,
    "name": "FPSO Module Project",
    "code": "FPSO-001",
    "start_date": "2026-01-01",
    "finish_date": "2026-12-31"
  }
]

GET/api/projects/{id}

Get project details

Response

{
  "id": 1,
  "name": "FPSO Module Project",
  "code": "FPSO-001",
  "versions": 5,
  "active_version": 3
}

POST/api/projects/upload

Upload XER file

Response

{
  "project_id": 1,
  "version": 3,
  "activities_count": 12500,
  "status": "processed"
}

Activities

GET/api/projects/{id}/activities

List activities for a project

Response

[
  {
    "id": 5001,
    "code": "A1010",
    "name": "Mobilise Construction Team",
    "duration": 10,
    "status": "in_progress"
  }
]

GET/api/activities/{id}

Get activity details

Response

{
  "id": 5001,
  "code": "A1010",
  "name": "Mobilise Construction Team",
  "original_duration": 10,
  "remaining_duration": 4,
  "total_float": 0,
  "critical": true
}

Analytics

GET/api/analytics/{id}/dcma

DCMA 14-Point compliance check

Response

{
  "score": 12,
  "max_score": 14,
  "percentage": 85.7,
  "checks": [
    {
      "name": "Logic Density",
      "passed": true
    }
  ]
}

AI Services

POST/api/ai/analyze

Get AI schedule insights

Response

{
  "predictions": {
    "finish_date": "2026-08-15",
    "confidence": 0.85,
    "risk_score": 42
  },
  "recommendations": [
    "Consider adding 2 weeks contingency to critical procurement"
  ]
}