Skip to content
KnockDevelopers
Knowledge

List FAQs

Chat with a Developer
GET
/v1/knowledge/faqs

Returns the FAQs your AI agent answers with, newest first. FAQs you turned off (enabled false) are not listed: read one with GET /v1/knowledge/faqs/{faqId}.

Pass reviewed=false for your review queue, the FAQs the AI agent drafted from questions contacts asked. Narrow the list with humanOnly, categoryIds and search: different filters all apply.

Authorization

ApiKeyAuth
headerx-api-key<token>

Your Knock API key. Ask your Knock account team for one: a key with the Enrichment API role to enrich and route leads, the Viewer role to read chats, meetings, routing rules and FAQs, or the Admin, Editor or AI Manager role to change FAQs.

Query Parameters

limit?integer

Page size.

Range1 <= value <= 100
Default20
offset?integer

Number of FAQs to skip.

Range0 <= value
Default0
reviewed?boolean

Set to false for your review queue: the FAQs the AI agent drafted that your team has not reviewed yet. true lists the reviewed ones.

humanOnly?boolean

true lists only the FAQs the AI agent hands to your team, false only the ones it answers.

categoryIds?array<>

Only FAQs in one of these categories, from GET /v1/knowledge/faqs/categories. Comma-separated or repeat the parameter; matches any of the values.

search?string

Only FAQs whose question contains this text, ignoring case.

Lengthlength <= 200

Response Body

A page of FAQs.

application/json
  1. response

A page of FAQs.

total*integer

Number of items that match the query, across all pages.

limit*integer

Page size of this page.

offset*integer

Number of items skipped before this page.

items*array<>

FAQs, newest first.

Example Request
curl -X GET 'https://app.knock-ai.com/v1/knowledge/faqs' \  -H 'x-api-key: <YOUR_API_KEY>'
Example Response
{  "total": 1,  "limit": 50,  "offset": 0,  "items": [    {      "faqId": "8f1e2d3c-4b5a-4c6d-9e7f-0a1b2c3d4e5f",      "question": "Do you offer a free trial?",      "answer": "Yes. Every plan starts with a 14-day free trial, no credit card needed.",      "categoryId": "2b4d6f8a-1c3e-4a5b-9d7f-0e2c4a6b8d1f",      "intent": "buying",      "source": "manual",      "answeredBy": "api",      "answeredByMemberId": null,      "humanOnly": false,      "enabled": true,      "published": true,      "reviewed": true,      "createdAt": "2026-11-02T12:00:00.000Z",      "updatedAt": "2026-11-02T12:00:00.000Z"    }  ]}