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

Stable insight ID.

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> | null
required

Date of the original source event; null when unknown.

Example:

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

updated_at
string<date-time>
required

When the insight last changed; used by incremental export. Moving an insight to another feature area by its own tag changes it; refiling it on an area or a product, and changes to your product structure, do not, so re-read /areas or the insight to see where it is filed now.

Example:

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

products
object[]
required

Active products the insight is filed under. Empty when none.

product_features
object[]
required

Features this insight supports, ordered by title. Empty when none.

category
string
Example:

"feature request"

customer_id
string<uuid> | null

The customer account this insight came from (see /customers). Context records use the same id.

Example:

"c0ffee00-0000-4000-8000-000000000001"

customer_name
string
Example:

"Acme Co"

source_date
string<date-time> | null
Example:

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

feature_area_id
string<uuid> | null

The feature area from /areas the insight is filed on. Null when it is filed on an area or a product, or not filed. Never an archived feature area.

feature_area_name
string | null
Example:

"Exports"

product_area_id
string<uuid> | null

The product area the insight is filed under: the area it is filed on, or an area of its feature area. Null when it is filed under none. Never an archived product area.

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"