Skip to main content
GET
Paginated list of knowledge-gap clusters with filters and sort

Authorizations

x-api-key
string
header
required

Query Parameters

agent_id
string<uuid> | null
gap_type
string | null
product_area
string | null
priority
string | null
status
string | null

Status filter. Omit for the default (open statuses: active, acknowledged, in_progress, reopened). Pass 'all' to include terminal states, or a comma-separated allowlist.

owner_user_id
string<uuid> | null
sort
string
default:impact_score:desc
Pattern: ^(impact_score:desc|last_seen_at:desc|affected_sessions:desc)$
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string | null
start_date
string<date>
required
end_date
string<date>
required

Response

Successful Response

items
ClusterListRow · object[]
required
next_cursor
string | null