Skip to main content
GET
List / search insights

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.

Query Parameters

q
string

Free-text search over titles and content.

category
string

Feedback category (e.g. bug, feature request, usability).

Example:

"bug"

severity
enum<string>
Available options:
critical,
high,
medium,
low
customer_id
string<uuid>

Filter to insights from one customer (same key as on context).

product_id
string<uuid>

Filter by one product ID from /products.

product_feature_id
string<uuid>

Filter by one buildable product feature ID from /features.

product_area_id
string<uuid>

Filter by one parent product-area ID from /areas.

feature_area_id
string<uuid>

Filter by one child feature-area ID from /areas. A feature area is the subject area an insight is filed under; it is NOT a buildable feature ID from /features, and the two are never interchangeable.

date_from
string<date>

Inclusive start date, as a real calendar date in YYYY-MM-DD. Any other form is rejected with 400 VALIDATION_ERROR - including 2026-5-1, 2026/05/01, May 1, 2026, a bare 2026, a date-time, and impossible dates such as 2026-02-30.

Pattern: ^\d{4}-\d{2}-\d{2}$
date_to
string<date>

Inclusive end date, as a real calendar date in YYYY-MM-DD. Validated by the same rule as date_from.

Pattern: ^\d{4}-\d{2}-\d{2}$
updated_since
string<date-time>

Start a fixed-watermark incremental export after this insight-row update timestamp. Cannot be combined with offset or cursor.

Must be a timezone-qualified ISO 8601 date-time - the offset is required, so 2026-05-01T00:00:00 (no Z or +hh:mm) is rejected with 400 VALIDATION_ERROR, as is a date-only value.

cursor
string

Opaque continuation cursor returned by the prior incremental page. A cursor request may include only cursor and limit. It is bound to the team, exact API key, filters, and watermark.

Maximum string length: 8192
limit
integer
default:50

Page size (max 200).

Required range: 1 <= x <= 200
offset
integer
default:0

Number of records to skip.

Required range: x >= 0

Response

A page of insights

data
object[]
pagination
object