Insights#
Get intelligence and alerts about your organization to surface opportunities and risks.
List organization insights#
List intelligence insights and alerts for an organization. Returns a mix of positive intelligence (campaign outperformance, creator efficiency) and actionable alerts (stale metrics, data gaps).
typescript
const { items, totalCount, facets } = await bw.insights.list({
organizationId: 'org_123',
});Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
Response#
Returns { items, totalCount, facets } with paginated results.
Dismiss insight#
Update an insight to mark it dismissed so it is hidden from future list responses for the organization.
typescript
const { data } = await bw.insights.dismiss({
insightId: '...',
});Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| insightId | string (UUID) | Required | Insight identifier to dismiss. |
Response#
Returns { data } with the result.