> ## Documentation Index > Fetch the complete documentation index at: https://docs.cloudhumans.com/llms.txt > Use this file to discover all available pages before exploring further. # List suggested content > The review queue: content Claudia proposes for questions your knowledge base did not answer. Each row carries why it was proposed and how many conversations hit the gap, so you can decide what is worth publishing. ## OpenAPI ````yaml /api-reference/specs/claudia/v1.json get /v1/knowledge-bases/{kbId}/improvements openapi: 3.0.1 info: title: Claudia API version: 1.0.0 servers: - url: https://api.cloudhumans.com/claudia description: Production - url: https://api.cloudhumans.com/claudia/staging description: Staging security: - bearerAuth: [] tags: - name: MCP Servers description: >- The MCP servers your agents can call tools on. Registering one here is what makes its tools selectable in an agent; the credentials it needs are stored encrypted and never read back. - name: Knowledge Base Content description: Read, search and edit the content that answers your customers. - name: Content Quality description: Rewrites proposed for content that is answering your customers badly. - name: Playground description: >- Talk to one of your agents as if you were a customer, without touching a real conversation. - name: Project Settings description: >- Read and change how a ClaudIA project behaves — the settings screens of the ClaudIA app, as an API. - name: Content Improvements description: Answers Claudia proposes for questions your content does not cover yet. - name: Knowledge Bases description: The knowledge bases your account can manage. - name: Content Sources description: The sites Claudia crawls to keep a knowledge base in sync. paths: /v1/knowledge-bases/{kbId}/improvements: get: tags: - Content Improvements summary: List suggested content description: >- The review queue: content Claudia proposes for questions your knowledge base did not answer. Each row carries why it was proposed and how many conversations hit the gap, so you can decide what is worth publishing. operationId: listImprovements parameters: - name: kbId in: path description: Knowledge base to operate on. Get the ids from listMyKnowledgeBases. required: true schema: type: string - name: status in: query description: >- Which queue to read. Only `pending` exists — a decided suggestion becomes ordinary content, readable through listEntries. required: false schema: type: string enum: - pending - name: offset in: query description: Rows to skip. Page with `total` and `hasNext` from the response. required: false schema: type: integer format: int32 default: 0 example: 0 - name: limit in: query description: Page size. Capped at 200. required: false schema: type: integer format: int32 default: 50 example: 50 - name: sortBy in: query description: Field to order by. required: false schema: type: string enum: - updatedAt - createdAt - type - tag default: createdAt - name: sortDir in: query description: Order direction. required: false schema: type: string enum: - asc - desc default: desc - name: searchTerm in: query description: Substring match on the suggested question and answer. required: false schema: type: string - name: label in: query description: Exact label match. Read the labels in use from getEntryTags. required: false schema: type: string - name: topic in: query description: Exact topic match. Read the topics in use from getEntryTopics. required: false schema: type: string responses: '200': description: One page of suggestions. content: application/json: schema: $ref: '#/components/schemas/ImprovementPage' '400': description: The request could not be answered as written. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing, expired or invalid credentials. '403': description: The credentials hold no account allowed to manage this content. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- No such resource, or none these credentials can reach — the two are deliberately indistinguishable. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limit applied by the API gateway. Back off and retry. components: schemas: ImprovementPage: required: - hasNext - items - limit - offset - total type: object properties: items: type: array description: The suggestions on this page. items: $ref: '#/components/schemas/Improvement' total: type: integer description: Total matching the query, across all pages. format: int64 example: 23 offset: type: integer description: Offset this page started at. format: int32 example: 0 limit: type: integer description: Page size actually applied (capped at 200). format: int32 example: 50 hasNext: type: boolean description: Whether another page follows. example: false description: One page of suggestions. Error: required: - error type: object properties: error: type: string description: What went wrong. example: 'Forbidden: token holds no claim for the requested account' description: Something the caller needs to fix. Improvement: required: - createdAt - disabled - hasPlaceholder - updatedAt type: object properties: id: type: string description: Use this id to edit, approve or reject the suggestion. example: 6683f1c2a4b19e0012ab34cd title: type: string description: The question customers asked that nothing answered. example: Vocês entregam no interior? response: type: string description: >- The answer being suggested. Edit it before approving if it needs work. label: type: string description: Tag suggested for this content. example: logistica topic: type: string description: Topic this content would be grouped under. example: Entregas type: type: string description: Support level the suggestion would answer at. example: N1 enum: - N1 - N2 - INTERACTIVE disabled: type: boolean description: >- Always true while pending — a suggestion only starts answering once approved. example: true gapStatus: type: string description: >- How the gap compares to what you already have: NEW, SIMILAR to existing content, or an answer that EXISTS but did not surface. enum: - NEW - SIMILAR - EXISTS rationale: type: string description: Why this gap was proposed. ticketCount: type: integer description: How many conversations in the analysed window hit this gap. format: int32 example: 14 sampleQuestions: type: array description: >- Real customer questions behind the gap, already stripped of personal data. items: $ref: '#/components/schemas/SampleQuestion' hasPlaceholder: type: boolean description: >- True when the suggested answer still carries a blank the pipeline could not fill (e.g. `[COMPLETAR: prazo]`). Approving it is refused until you edit it. example: false createdAt: type: string description: When it was suggested (ISO-8601). example: '2026-08-10T14:32:05' updatedAt: type: string description: When it last changed (ISO-8601). example: '2026-08-10T18:20:41' description: >- An answer Claudia suggests for a question your content does not cover yet. SampleQuestion: required: - conversationId - text type: object properties: conversationId: type: string description: >- Conversation the question came from, so you can read it in CloudChat. text: type: string description: What the customer asked, stripped of personal data. description: A customer question behind a suggestion. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````