Signals
Signal-kind sips — derived intelligence synthesized from related events and actions
Search synthesized signals
Returns signal-kind sips. Searches without q are sorted by created descending; semantic searches with q are ranked by cosine distance, most similar first.
When to use: retrieve synthesized business implications, forecasts, drivers, and cross-event patterns after or instead of searching raw events.
Search modes: use ids for exact UUID lookup, tags for inclusive-AND tag filtering, q + acc for semantic search, and from to set the oldest creation date. These filters can be combined.
Default time window: when from is omitted, the service uses its default recent window, currently about the last 7 days.
Response shape: JSON responses are flattened digest objects with id and reported added by the router. Stable fields include briefing, events, drivers, impacts, impacted_domains, forecast, impact_level, and tags; additional pipeline-specific keys may appear.
Agent format: use response_type=text for compact field-per-line records when feeding an LLM or MCP client. Use JSON when the caller needs structured parsing.
query Parameters
idsExact signal sip UUIDs to fetch (CSV). Use when following references or retrieving known records.
tagsTag filters (CSV). Multiple values are inclusive AND, so every supplied tag must match.
qNatural-language semantic search query. Max 1024 characters; requires the embedder.
accMatch strictness for q. 0.0=broad, 1.0=strict. Default 0.5.
fromOnly include signals created on or after this date (YYYY-MM-DD). Defaults to the recent window when omitted.
response_typeOutput format. json returns flattened digest objects; text returns compact plain-text records for LLM/MCP context.
limitPage size. Default 16, max 128.
offsetNumber of signals to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Search synthesized signals › Responses
Signal digests when response_type=json; plain-text signal blocks when response_type=text
idSip UUID (RFC 4122).
reportedReported timestamp of the sip (maps from persisted created).
briefingConcise summary of the signal.
impact_levelAssessed impact severity.
forecastForward-looking outlook synthesized from related events.
eventsRelated events that contributed to this signal.
impactsObserved or projected impacts.
driversUnderlying drivers or catalysts.
impacted_domainsBusiness or policy domains affected by the signal.
tagsScalar tags for filtering and discovery.

