> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch knowledge gaps

> List the knowledge gaps in your workspace or fetch one by ID.

There are two ways to fetch knowledge gaps:

* [Get knowledge gaps](#get-knowledge-gaps): paginated collection, filtered by status and sorted by signal count or recency
* [Get knowledge gap by ID](#get-knowledge-gap-by-id)

<Note>
  Knowledge gaps are in beta. The queries and fields on this page may change without a deprecation period.
</Note>

<Snippet file="graphql/sdk-note.mdx" />

These operations require the following permissions:

* `knowledgeGap:read`
* `task:read` to read the linked `task`

## Get knowledge gaps

Filter with `statuses`, which takes any of `TODO`, `DONE`, and `CANCELLED`. Sort with `sortBy`: `SIGNAL_COUNT` orders by how many customer conversations hit the gap, `LAST_SEEN_AT` by when the most recent one did. The default is `SIGNAL_COUNT` descending.

<Snippet file="graphql/get-knowledge-gaps.mdx" />

## Get knowledge gap by ID

<Snippet file="graphql/get-knowledge-gap-by-id.mdx" />