API Reference
Log In
API Reference

Trigger an insights run

Trigger a new AI insights analysis run for the team. Returns 202 Accepted immediately with the runId and initial status. Poll GET /api/v2/insights/runs/{runId} until status transitions to completed, partial, or failed.

A Location response header points directly to the polling URL.

In local development (no ANALYSIS_LAMBDA_ARN set), the run executes synchronously and the response header X-Local-Sync-Fallback: true is set — the run will already be complete when the 202 is received.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string | null
required
string | null
required
filterAgent
array of strings
Defaults to []
filterAgent
filterProductId
array of strings
Defaults to []
filterProductId
filterTraceType
array of strings
Defaults to []
filterTraceType
filterConsumingOrgId
array of strings
Defaults to []
filterConsumingOrgId
string
boolean
Defaults to true
boolean
Defaults to false
excludeInvestigatorIds
array of strings
excludeInvestigatorIds
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json