Build on Konnect xD
APIs, SDKs, and guides for building EPC applications on the Konnect xD platform.
Navigate Docs
Getting Started
Welcome to the Konnect xD Developer Documentation. This guide covers everything you need to build applications and integrations on the Konnect xD platform.
Platform Overview
Konnect xD is built on a microservices architecture with multiple backend APIs serving specific domains: Core API (authentication, projects, user management), Data Exploration API (tag registry, P&ID data), Analytics API (KPIs, dashboards), 3D Visualization API (model data, geometry), 4D Planning API (schedule data), and 5D Cost API (budget tracking).
Authentication
All API endpoints require Azure AD (Entra ID) authentication via Bearer token. Obtain a token from your Azure AD tenant, then include it in every request.
Authorization: Bearer {access_token}
// Example fetch call
const response = await fetch('https://api.konnectxd.com/core/v1/projects', {
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
});Core API
The Core API provides CRUD operations for projects, activities, resources, and their relationships.
List Projects
Retrieve all projects accessible by the authenticated user.
GET /api/projects
// Response
[
{
"id": 1,
"name": "FPSO Module Project",
"code": "FPSO-001",
"start_date": "2026-01-01",
"finish_date": "2026-12-31"
}
]Upload XER File
Upload a Primavera P6 XER file to create or update a project schedule.
POST /api/projects/upload
Content-Type: multipart/form-data
file: <xer_file>
// Response
{
"project_id": 1,
"version": 3,
"activities_count": 12500,
"status": "processed"
}DCMA 14-Point Compliance
Run the industry-standard DCMA 14-Point schedule compliance check against a project.
GET /api/analytics/{project_id}/dcma
// Response
{
"score": 12,
"max_score": 14,
"percentage": 85.7,
"checks": [
{
"name": "Logic Density",
"passed": true,
"details": "1.8 relationships per activity"
}
]
}Data Platform
The Konnect Core data platform uses a Medallion Architecture (Bronze/Silver/Gold) with Apache Iceberg and Nessie catalog.
Plugin Integration
External applications connect to Konnect Core as plugins. Each plugin registers via the Plugin API, receives an API key, and can read/write to the Gold layer through structured data contracts.
POST /api/plugins/register
{
"name": "My Custom App",
"type": "analytics",
"permissions": ["read:projects", "read:activities"]
}
// Response
{
"plugin_id": "plg_abc123",
"api_key": "kxd_live_...",
"endpoints": {
"data": "https://api.konnectxd.com/plugins/plg_abc123/data"
}
}