Expansion Intelligence API
The Expansion Intelligence API manages the product affinity matrix and expansion signals. It includes endpoints for querying and recomputing co-adoption data, generating prioritized expansion signals, and updating signal status as opportunities progress.GET /api/expansion/affinity
Returns the product affinity matrix showing co-adoption patterns between products.
Auth: Requires authenticated session. Scoped to organization.
Query Parameters
Response
Response Fields: matrix[]
POST /api/expansion/affinity
Recomputes the affinity matrix from current account product data. Deletes existing entries for the org and inserts fresh computations.
Auth: Requires authenticated session. Scoped to organization.
Request Body
No body required.Response
Computation Flow
- Fetch active products, account_products, and accounts
- Compute overall affinity matrix (all segments combined)
- Compute per-segment affinity (Enterprise, Mid-Market, SMB)
- Delete existing matrix entries for the org
- Insert all new entries
GET /api/expansion/signals
Returns prioritized expansion signals with account and product enrichment.
Auth: Requires authenticated session. Scoped to organization.
Query Parameters
Response
Response Fields: kpi
Response Fields: signals[]
POST /api/expansion/signals
Generates expansion signals for all active accounts using affinity data.
Auth: Requires authenticated session. Scoped to organization.
Request Body
No body required.Response
Side Effects
- Deletes existing
pendingsignals for the org (preservespitched,won,dismissed) - Inserts freshly computed signals
PATCH /api/expansion/signals
Updates the status of an expansion signal as it progresses through the sales process.
Auth: Requires authenticated session. Scoped to organization.
Request Body
Response
See the Product Affinity data model page for full details on the affinity matrix computation and expansion scoring methodology.