> ## Documentation Index
> Fetch the complete documentation index at: https://hc.pillargtm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Decision Engine API

> Strategic intelligence -- territory health, financial cascades, what-if modeling, board scenarios

# Decision Engine API

The Decision Engine API synthesizes signal data, territory economics, pipeline cohorts, and headcount planning into strategic decisions with financial modeling.

## GET `/api/decision-engine`

Returns the full Decision Engine output: territory health scores, financial cascades, rebalance recommendations, board scenarios, and rep performance KPIs.

**Auth:** Requires authenticated session. Scoped to organization.

**Access:** Executive and RevOps roles only.

### Response Contents

The response includes:

* **Summary** -- Org-level metrics: total ARR, territory count, health distribution, total at-risk ARR, pipeline total, and counts of proposals and cascades
* **Territory Health** -- Per-territory health scores with status classification, pipeline coverage, deal velocity, signal counts, and financial metrics
* **Financial Impacts** -- Per-account financial cascade analysis showing ARR at risk, cost-to-yield impact, NRR impact, and narrative descriptions
* **Rebalance Proposals** -- System-generated recommendations for account reassignment, headcount additions, or territory restructuring with projected impact
* **Board Scenarios** -- Three scenarios (current trajectory, optimized execution, downside risk) with projected ARR, NRR, GRR, attainment, and detailed assumptions
* **Rep Performance** -- Per-rep KPIs including win rate, pipeline, deal velocity, account health, attainment, and efficiency metrics

### Side Effects

On every GET request, the Decision Engine persists territory health scores for cross-dashboard access.

***

## POST `/api/decision-engine`

What-if modeling -- propose a change and see the projected financial impact.

### Actions

#### Account Reassignment

Model moving accounts between territories. Returns before/after territory health, pipeline coverage change, and cost-to-yield shift.

#### Add Headcount

Model adding a new hire (AE, CSM, or SDR) to a territory. Returns multi-scenario revenue projections, fully loaded cost, ROI, breakeven timeline, and projected territory health change.

> Detailed API response schemas and modeling parameters are available in the PILLAR Implementation Guide provided to active customers.