Insights#

Get intelligence and alerts about your organization to surface opportunities and risks.

Authentication required

All endpoints require a Bearer token in the Authorization header. See the Authentication guide for setup instructions.

GET /v1/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).

bash

GET /v1/insights?organization_id=org_123
Authorization: Bearer {token}

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.

Response#

Returns { items, totalCount, facets } with paginated results.

Underlying SDK method: bw.insights.list(params)

PATCH /v1/insights/:id/dismiss#

Update an insight to mark it dismissed so it is hidden from future list responses for the organization.

bash

PATCH /v1/insights/:id/dismiss
Authorization: Bearer {token}
Content-Type: application/json

{
  "insight_id": "..."
}

Parameters#

Name	Type	Required	Description
insightId	`string (UUID)`	Required	Insight identifier to dismiss.

Response#

Returns { data } with the result.

Underlying SDK method: bw.insights.dismiss(params)