---
title: "List content gaps"
method: GET
path: "/api/agent/gaps"
tags: ["Gaps"]
---

# List content gaps

`GET /api/agent/gaps`

List saved content gaps. Optional `favorite_id` scopes results to a product/identity (hybrid filter keeps legacy NULL gaps visible via domain-match).

## Query parameters

- `favorite_id` string, uuid
- `limit` integer

## Response `200`

List of gaps

- ListGapsResponse
  - `gaps` GapItem[], required
    - `id` string, uuid
    - `title` string, required
    - `gap_type` string, required
    - `priority` string, required
    - `opportunity_score` number, nullable
    - `status` string
    - `description` string, nullable
    - `favorite_id` string, uuid, nullable — Favorite (product identity) ID this gap is scoped to, or null for legacy tenant-wide gaps.
    - `created_at` string, date-time
  - `total_gaps` integer, required
  - `credits_used` number, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate limit exceeded
- `500` — Internal server error

## Changes

> 28 revisions in range; 1 could not be searched.

- **2026-05-04** `ad161f576254` — 4 info
  - added the new optional `query` request parameter `favorite_id`
  - added the new optional `query` request parameter `limit`
  - added the non-success response with the status `400`
  - added the optional property `gaps/items/favorite_id` to the response with the `200` status
- **2026-03-01** `2df2182b5901` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/citedy/apis/citedy-agent-api/changes/api/agent/gaps/get.md)

---

[API](https://skmtc.dev/citedy/apis/citedy-agent-api.md) · [All operations](https://skmtc.dev/citedy/apis/citedy-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citedy/citedy-agent-api/revisions/b5785d3fe446/schema)