Skip to content
KnockDevelopers
Knowledge

Draft an FAQ answer

Chat with a Developer
post/v1/knowledge/faqs/draft-answer

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

Has the AI agent draft an answer from your knowledge base, for a new question or for one of your FAQs' questions. Nothing is saved: send the answer to POST /v1/knowledge/faqs or PATCH /v1/knowledge/faqs/{faqId} to keep it.

The answer usually takes a few seconds, and two calls for the same question can draft different answers.

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

The question to draft an answer for: a new one, or the question of one of your FAQs.

question?string

A question. Required unless you send faqId; it wins when you send both.

Length1 <= length <= 1000
faqId?string

One of your FAQs, to draft an answer to its question.

Formatuuid

Response Body

The drafted answer.

application/json
  1. response

An answer the AI agent drafted. It is not saved.

answer*|

The drafted answer, from your knowledge base. Null when the AI agent found nothing to answer the question with.

Example Request
curl -X POST 'https://app.knock-ai.com/v1/knowledge/faqs/draft-answer' \  -H 'x-api-key: <YOUR_API_KEY>' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "answer": "Yes. Every plan starts with a 14-day free trial, no credit card needed."}