Skip to content
KnockDevelopers
Knowledge

Review FAQs

Chat with a Developer
post/v1/knowledge/faqs/review

No “Try it” here: every call is real and consumes enrichment credits. Run the code samples from your own backend.

Marks FAQs as reviewed, such as the ones the AI agent drafted, or sends them back to your review queue with reviewed: false. FAQs that are not yours, or were deleted, are returned in notFoundFaqIds and the rest are still marked. Marking an FAQ again is harmless.

Marking only takes an FAQ out of the queue: the AI agent answers with a drafted FAQ once its answer is replaced with PATCH /v1/knowledge/faqs/{faqId}, which also marks it reviewed.

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.

Request Body

application/json
  1. body

FAQs to mark as reviewed, or to send back to your review queue.

faqIds*array<>

The FAQs, from 1 to 100, each once.

Items1 <= items <= 100
reviewed?boolean

Set to false to send the FAQs back to your review queue.

Defaulttrue

Response Body

Which FAQs were marked.

application/json
  1. response

Which FAQs were marked.

updatedFaqIds*array<>

The FAQs now marked as you asked.

notFoundFaqIds*array<>

The faqIds that are not FAQs of yours, or were deleted: nothing was changed for them.

Example Request
curl -X POST 'https://app.knock-ai.com/v1/knowledge/faqs/review' \  -H 'x-api-key: <YOUR_API_KEY>' \  -H 'Content-Type: application/json' \  -d '{  "faqIds": [    "8f1e2d3c-4b5a-4c6d-9e7f-0a1b2c3d4e5f"  ]}'
Example Response
{  "updatedFaqIds": [    "8f1e2d3c-4b5a-4c6d-9e7f-0a1b2c3d4e5f"  ],  "notFoundFaqIds": []}