Skip to main content
GET
Get an insight

Authorizations

X-API-Key
string
header
required

Team-scoped API key created in the app (Settings → API Keys). Sent as X-API-Key: <key> on every request. The header name apikey is also accepted as an alias.

Path Parameters

id
string<uuid>
required

Resource UUID.

Response

Insight detail

id
string<uuid>
required

Immutable UUID; never reassigned to another insight.

Example:

"123e4567-e89b-42d3-a456-426614174000"

title
string
required
Example:

"Users want a dark mode toggle"

severity
enum<string>
required
Available options:
critical,
high,
medium,
low
Example:

"medium"

source
string
required
Example:

"gong_call_abc123"

created_at
string<date-time>
required
Example:

"2026-05-14T10:32:00Z"

updated_at
string<date-time>
required

Insight-row update timestamp used by incremental export.

Example:

"2026-05-15T08:12:00Z"

products
object[]
required

Recorded product associations. Empty when the insight is unassigned. Some insights cannot be matched automatically with enough confidence.

product_features
object[]
required

Recorded buildable-feature associations, ordered by title and ID. Empty when the insight has no reliable feature match.

category
string
Example:

"feature request"

customer_id
string<uuid> | null

Resolved customer: the shared key that links an insight to its context (same customer).

Example:

"c0ffee00-0000-4000-8000-000000000001"

customer_name
string
Example:

"Acme Co"

source_date
string<date-time>
Example:

"2026-05-14T10:30:00Z"

feature_area_id
string<uuid> | null
feature_area_name
string | null
Example:

"Exports"

product_area_id
string<uuid> | null
product_area_name
string | null
Example:

"Operations"

content
string

Insight content (always English).

Example:

"The customer wants a dark mode option for night-time use."

quote
string

Verbatim supporting quote.

Example:

"I'd honestly pay more if you just had a dark theme."

pain_point
string
Example:

"Bright interface is hard to use in low light."

workaround
string
Example:

"Uses a browser dark-mode extension."

competitor_gap
string
Example:

"Competitor X ships native dark mode."

willingness_to_pay
string
Example:

"High"

feature_area
string
Example:

"UI/UX"

source_url
string<uri>
Example:

"https://gong.io/calls/abc123"