API Reference

This API reference is synchronized to the OpenAPI document served from /openapi.json and rendered with BellatorSI-specific context for standards, API categories, and operational behavior.

Use this page as your starting point, then drill into individual operation pages for parameter-level detail.

Current availability

Health is scored checks only: POST /api/v1/health/score, /logic-audit, /progress-audit, /dcma-14-point, /dcma-decm, /planning-horizon, /schedule-risk-index. Health score does not build the DAG and does not run CPM.
Analysis is POST /api/v1/analysis/validate, /cpm, and /resources.
Forensics is comparison only: POST /api/v1/forensics/delay-analysis, /change-tracking, /baseline-compare, /as-planned-vs-as-built.
Service liveness is GET /health and GET /api/v1/infrastructure/health. Those are not a health score.
POST /api/v1/schedule/health and POST /api/v1/schedule/analyze return 410. They are not aliases of /health/score.
Retired quality and schedule paths are 308 only. See Changelog. Do not document them as current calls.
Risk & Simulation is not implemented. Do not call simulation paths. Do not document /forensics/evm-analysis. Simulation tools are not MCP tools.
MCP: GET /mcp/tools lists 14 family-prefixed names. POST /mcp/tools/{name} invokes one listed tool.
The route-level catalog and operation detail pages are generated from the active API contract to minimize documentation drift.

Method	Path	Name	Plan	Async
Health
post	/api/v1/health/score	Health score	Free	Yes · /api/v1/health/score/async
post	/api/v1/health/logic-audit	Logic audit	Starter+	Yes · /api/v1/health/logic-audit/async
post	/api/v1/health/progress-audit	Progress audit	Starter+	Yes · /api/v1/health/progress-audit/async
post	/api/v1/health/dcma-14-point	DCMA 14-Point	Starter+	Yes · /api/v1/health/dcma-14-point/async
post	/api/v1/health/dcma-decm	DCMA DECM	Starter+	Yes · /api/v1/health/dcma-decm/async
post	/api/v1/health/planning-horizon	Planning horizon	Starter+	Yes · /api/v1/health/planning-horizon/async
post	/api/v1/health/schedule-risk-index	Schedule risk index	Starter+	Yes · /api/v1/health/schedule-risk-index/async
Analysis
post	/api/v1/analysis/validate	Validate	Free	—
post	/api/v1/analysis/cpm	Critical path	Free	Yes · /api/v1/analysis/cpm/async
post	/api/v1/analysis/resources	Resource analysis	Starter+	Yes · /api/v1/analysis/resources/async
Forensics
post	/api/v1/forensics/delay-analysis	Delay analysis	Starter+	Yes · /api/v1/forensics/delay-analysis/async
post	/api/v1/forensics/change-tracking	Change tracking	Starter+	Yes · /api/v1/forensics/change-tracking/async
post	/api/v1/forensics/baseline-compare	Baseline compare	Starter+	Yes · /api/v1/forensics/baseline-compare/async
post	/api/v1/forensics/as-planned-vs-as-built	As-planned vs as-built	Starter+	Yes · /api/v1/forensics/as-planned-vs-as-built/async
Import
post	/api/v1/import/xer	P6 XER	Starter+	—
post	/api/v1/import/mpp	MS Project	Starter+	—
Jobs / webhooks / account
get	/api/v1/jobs/{job_id}	Job status	All	—
delete	/api/v1/jobs/{job_id}	Delete job	All	—
post	/api/v1/jobs/{job_id}/cancel	Cancel job	All	—
post	/api/v1/webhooks/register	Register webhook	All	—
get	/api/v1/webhooks/registration	Webhook registration	All	—
delete	/api/v1/webhooks/registration	Delete registration	All	—
get	/api/v1/webhooks/deliveries/{webhook_id}	Webhook delivery	All	—
get	/api/v1/account/tier	Account tier	All	—
Service
get	/health	Service liveness	Public	—
get	/api/v1/infrastructure/health	Infrastructure liveness	Public	—

Authentication and Required Headers

All protected routes require an API key header:

x-api-key: YOUR_API_KEY

Related docs:

Authentication workflow: /docs/authentication
Error behavior and retry guidance: /docs/errors

Request and Response Model

Track A endpoints are stateless. You send schedule data in each request and receive deterministic analysis results.

Single-schedule analysis: send one normalized schedule payload.
Comparison and forensic analysis: send all required datasets in the same request body.
No project persistence in Track A endpoints.

For payload structure and field semantics, use:

Task schema guide: /docs/task-schema-guide
Import normalization workflow: /docs/import-guide

Tiering, Limits, and Processing Mode

Synchronous threshold: up to 1,000 tasks.
Above sync threshold: async endpoints with job polling and optional webhook callbacks.
Access and task limits are tier-gated at runtime.

Use direct API calls for async workflows. The web playground is intentionally scoped for interactive testing.

Async Job Flow

For async-capable endpoints:

Submit to the async route.
Receive a job identifier.
Poll job status or receive webhook callback on completion.
Retrieve final result payload.

See /docs/webhooks for callback contracts and signature validation.

Compliance Context

Bellator references multiple schedule standards in deterministic analysis outputs, including:

DCMA 14-Point
GAO Schedule Assessment Guide
AACE recommended practices
Additional framework mappings documented in /docs/standards

OpenAPI Contract Access

Machine-readable contract: /openapi.json
Human-friendly index and operation navigation: this API reference section

When integrating SDK generation or internal tooling, treat /openapi.json as the source of truth.