***

title: AI-generated examples
description: >-
Automatically create realistic API examples with Fern's AI feature. Customize
example styles or disable AI generation as needed.
--------------------------------------------------

For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see [https://buildwithfern.com/learn/llms.txt](https://buildwithfern.com/learn/llms.txt). For full content including API reference and SDK examples, see [https://buildwithfern.com/learn/llms-full.txt](https://buildwithfern.com/learn/llms-full.txt).

Fern uses AI to automatically generate realistic request and response examples for your [API Reference](/learn/docs/api-references/generate-api-ref) documentation. This feature is enabled by default for all API Reference pages. Instead of placeholder values like `username: "string"`, you get believable data that reflects your endpoint properties and descriptions. Examples update automatically as your spec changes.

AI examples work alongside manual examples defined in [`x-fern-examples`](/learn/api-definitions/openapi/extensions/request-response-examples), with manual examples taking priority.

<Tabs>
  <Tab title="Before">
    <Frame>
      <img src="https://files.buildwithfern.com/fern.docs.buildwithfern.com/learn/58a62c8ab09b5b2ecb168e458fe5f5b9ec2d0bbf049ac8eb51b6275005e735da/products/docs/pages/ai/ai-examples-before.png" alt="API Reference with placeholder string values" />
    </Frame>
  </Tab>

  <Tab title="After">
    <Frame>
      <img src="https://files.buildwithfern.com/fern.docs.buildwithfern.com/learn/ce0a22df25ed3bb69c69cb4f273134541aa38f807462d9d83df364be2cc8241f/products/docs/pages/ai/ai-examples-after.png" alt="API Reference with AI-generated realistic example values" />
    </Frame>
  </Tab>
</Tabs>

## Configuration

Customize the style of generated examples:

```yaml docs.yml
ai-examples:
  style: "Use names and emails that are inspired by plants."
```

Or disable the feature entirely:

```yaml docs.yml
ai-examples:
  enabled: false
```

AI-generated examples are written to `ai_examples_override.yml`. Edit this file to customize specific examples. To regenerate examples on each build instead, add the file to `.gitignore`:

```txt .gitignore
**/ai_examples_override.yml
```