# November 5, 2025

## HTTP API access for AI agents

AI agents can now access authenticated documentation directly via HTTP API. This enables custom integrations and AI tools to retrieve protected content programmatically.

Agents obtain a JWT via the `/api/fern-docs/get-jwt` endpoint with a Fern API key, then use it to access protected documentation:

```bash
curl https://docs.example.com/platform/overview \
  -H 'Accept: text/plain' \
  -H 'x-fern-host: docs.example.com' \
  -H 'FERN_TOKEN: your-jwt-here'
```

Content is served as clean Markdown for token-efficient processing.

## Folder-based navigation

Auto-generate navigation from a folder of markdown files using the new `folder` configuration. Instead of manually listing each page in `docs.yml`, point to a folder. Fern discovers all `.md` and `.mdx` files and adds them to the navigation.

```yaml docs.yml {6-10}
navigation:
  - section: Getting started
    contents:
      - page: Introduction
        path: ./pages/intro.mdx
      - folder: ./pages/guides
        title: Guides # Display name for folder section
        icon: fa-regular fa-book
        collapsed: true
        availability: beta # Optional badge to display in navigation
```

Subfolders become nested sections. Supported options: `title`, `slug`, `icon`, `collapsed`, `hidden`, `skip-slug`, `availability`.

[Learn more about navigation configuration](/learn/docs/configuration/navigation).