Skip to main content
GET
/
v1
/
knowledge-gaps
/
clusters
Paginated list of knowledge-gap clusters with filters and sort
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/knowledge-gaps/clusters \
  --header 'x-api-key: <api-key>'
{
  "items": [
    {
      "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "gap_type": "<string>",
      "status": "<string>",
      "impact_score": 123,
      "member_count": 123,
      "affected_sessions": 123,
      "escalation_count": 123,
      "unresolved_count": 123,
      "gap_event_count": 123,
      "first_seen_at": "2023-11-07T05:31:56Z",
      "last_seen_at": "2023-11-07T05:31:56Z",
      "label": "<string>",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "product_area": "<string>",
      "priority": "<string>",
      "owner_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "fixed_at": "2023-11-07T05:31:56Z",
      "reopened_at": "2023-11-07T05:31:56Z"
    }
  ],
  "next_cursor": "<string>"
}

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