> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Draft a fix for an AI search gap

> Beta. A section answering a gap’s question, written only from your own knowledge base, or a plain statement that it does not say enough.

**Beta.** Drafts a section your site or docs could add for one [gap](https://docs.mithunai.com/api-reference/geo/list-gaps.md): 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](https://docs.mithunai.com/analyze/usage-and-limits.md). Requires the owner or admin role.

> [!WARNING]
>
> AI search visibility is in **beta**. Every route answers `404` unless your deployment has switched
> it on. See [AI search visibility](https://docs.mithunai.com/analyze/ai-search-visibility.md).

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](https://docs.mithunai.com/api-reference/geo/propose-fix.md), or add a source that covers it.

**prompt\_id** `string` *required*

The gap's tracked question, as `prompt.id` in the gap. A question not in the latest check returns
`404`.

**engine** `string` *required*

The gap's engine: `openai`, `anthropic` or `perplexity`.

**assistant\_id** `string` *required*

The assistant whose knowledge bases the fix is written from (UUID). Another organization's
assistant returns `404`.

## Response

**outcome** `string` *required*

`drafted`, or `insufficient_content`. Treat a value you do not recognise as
`insufficient_content`.

**body** `string` *required*

The section, as Markdown. The characters `<`, `{` and `}` are escaped, so the text cannot become HTML or an MDX
expression on your site.

**title** `string` *required*

A one-line title for the fix.

**why** `string` *required*

Why the fix should help, from the names you track.

**sources** `object[]` *required*

The passages it was written from: `title`, `url` (or `null`) and `snippet` (or `null`).

**suggested\_path** `string` *required*

A file name taken from the question. Choose the real path yourself.

**beta\_note** `string` *required*

The note to show beside the fix.

Also returned: `prompt_id`, `engine` and `question`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.