Skip to main content
POST
Draft a fix for an AI search gap
Beta. Drafts a section your site or docs could add for one gap: your tracked question as a heading, and an answer written through the assistant’s normal answer path, with the same search of its knowledge bases, grounding and refusal to guess. What is drafted for is your own question, never the competing answer the engine gave. Nothing is sent anywhere. A draft counts as one answer against your monthly allowance. Requires the owner or admin role.
AI search visibility is in beta. Every route answers 404 unless your deployment has switched it on. See AI search visibility.
When the knowledge base does not say enough, outcome is insufficient_content and title and body are empty. Write the section yourself and propose it, or add a source that covers it.
string
required
The gap’s tracked question, as prompt.id in the gap. A question not in the latest check returns 404.
string
required
The gap’s engine: openai, anthropic or perplexity.
string
required
The assistant whose knowledge bases the fix is written from (UUID). Another organization’s assistant returns 404.

Response

string
required
drafted, or insufficient_content. Treat a value you do not recognise as insufficient_content.
string
required
The section, as Markdown. The characters <, { and } are escaped, so the text cannot become HTML or an MDX expression on your site.
string
required
A one-line title for the fix.
string
required
Why the fix should help, from the names you track.
object[]
required
The passages it was written from: title, url (or null) and snippet (or null).
string
required
A file name taken from the question. Choose the real path yourself.
string
required
The note to show beside the fix.
Also returned: prompt_id, engine and question.
Last modified on November 12, 2026