> ## 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.

# Signals API

> Signal management, lifecycle transitions, and Starbridge webhooks

# Signals API

## List Signals

```
GET /api/signals
```

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

## Starbridge Webhook

```
POST /api/signals/starbridge-webhook
```

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

## Signal Lifecycle Transitions

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                           |

## Signal Object

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      |