Signals API

List Signals

GET /api/signals

Returns signals filtered by family, severity, state, account, and date range.

POST /api/signals/starbridge-webhook

Receives real-time Starbridge events (job changes, RFP publications, budget shifts) and generates corresponding signals.

Signals follow the 7-state lifecycle. Valid transitions:

From	To
PENDING	ACTIVE, SUPPRESSED
ACTIVE	ACKNOWLEDGED, RESOLVED, EXPIRED, SUPPRESSED
ACKNOWLEDGED	IN_PROGRESS, RESOLVED, EXPIRED, SUPPRESSED
IN_PROGRESS	RESOLVED, EXPIRED

Each signal includes:

Field	Description
ID	Signal identifier
Signal Type	Type code
Family	One of 8 families
Severity	CRITICAL, WARNING, or INFO
State	Current lifecycle state
Title	Human-readable title
Explanation	Plain-language explanation
Recommended Action	AI-generated recommendation
Evidence	Supporting data references
Confidence	0-100 confidence level