Schemas

ErrorResponse

Standard JSON error envelope for 4xx and 5xx responses.

error

string · required

Human-readable error message.

Event

Flattened JSON shape returned for event-kind sips. The handler merges persisted sip metadata (`id`, `reported`) into the digest before responding. Individual records may include additional pipeline-specific keys not listed here.

id

string · uuid

Sip UUID (RFC 4122).

reported

string · date-time

Reported timestamp of the sip (maps from persisted created).

briefing

string

Concise summary of the event.

event_type

string

Category or classification of the event.

impact_level

string · enum

Assessed impact severity.

Enum values:

low

medium

high

future_outlook

string

Forward-looking assessment of likely developments.

actions

string[]

Micro actions or developments that compose the event.

cross_domain_impacts

string[]

Effects spanning multiple domains or sectors.

companies

string[]

Companies or organizations associated with the event.

products

string[]

Products or commodities associated with the event.

macro_context

string

Broader macroeconomic or geopolitical context for the event.

people

string[]

People mentioned or involved in the event.

regions

string[]

Geographic regions associated with the event.

tags

string[]

Scalar tags for filtering and discovery.

Signal

Flattened JSON shape returned for signal-kind sips. The handler merges persisted sip metadata (`id`, `reported`) into the digest before responding. Individual records may include additional pipeline-specific keys not listed here.

id

string · uuid

Sip UUID (RFC 4122).

reported

string · date-time

Reported timestamp of the sip (maps from persisted created).

briefing

string

Concise summary of the signal.

impact_level

string · enum

Assessed impact severity.

Enum values:

low

medium

high

forecast

string

Forward-looking outlook synthesized from related events.

events

string[]

Related events that contributed to this signal.

impacts

string[]

Observed or projected impacts.

drivers

string[]

Underlying drivers or catalysts.

impacted_domains

string[]

Business or policy domains affected by the signal.

tags

string[]

Scalar tags for filtering and discovery.

Event

id

string · uuid

Sip UUID (RFC 4122).

reported

string · date-time

Reported timestamp of the sip (maps from persisted created).

briefing

string

Concise summary of the event.

event_type

string

Category or classification of the event.

impact_level

string · enum

Assessed impact severity.

Enum values:

low

medium

high

future_outlook

string

Forward-looking assessment of likely developments.

actions

string[]

Micro actions or developments that compose the event.

cross_domain_impacts

string[]

Effects spanning multiple domains or sectors.

companies

string[]

Companies or organizations associated with the event.

products

string[]

Products or commodities associated with the event.

macro_context

string

Broader macroeconomic or geopolitical context for the event.

people

string[]

People mentioned or involved in the event.

regions

string[]

Geographic regions associated with the event.

tags

string[]

Scalar tags for filtering and discovery.

Signal

id

string · uuid

Sip UUID (RFC 4122).

reported

string · date-time

Reported timestamp of the sip (maps from persisted created).

briefing

string

Concise summary of the signal.

impact_level

string · enum

Assessed impact severity.

Enum values:

low

medium

high

forecast

string

Forward-looking outlook synthesized from related events.

events

string[]

Related events that contributed to this signal.

impacts

string[]

Observed or projected impacts.

drivers

string[]

Underlying drivers or catalysts.

impacted_domains

string[]

Business or policy domains affected by the signal.

tags

string[]

Scalar tags for filtering and discovery.