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

# Introduction

> Seven endpoints: create, poll, enrich, export - for single runs and batches.

Base URL: `https://preuve.ai`

All endpoints require [HMAC authentication](/authentication) and return JSON. Errors use a stable `{ error, code }` envelope - see [Errors](/errors).

<Warning>
  The interactive playground cannot compute HMAC signatures, so requests sent from these pages
  return an auth error. Use the pages for request/response shapes; make real calls with the
  [reference client](/quickstart) or the [MCP server](/mcp-server).
</Warning>

## Endpoints

| Endpoint                                       | Method | Purpose                                              |
| ---------------------------------------------- | ------ | ---------------------------------------------------- |
| `/api/agent/analyses`                          | POST   | Start one analysis                                   |
| `/api/agent/analyses/{id}`                     | GET    | Poll one analysis                                    |
| `/api/agent/analyses/{id}/enrich`              | POST   | Generate missing core sections + opt-in deep modules |
| `/api/agent/analyses/{id}/export`              | GET    | Export one completed analysis (`ideas-json`)         |
| `/api/agent/analysis-batches`                  | POST   | Start a batch (up to 10 items)                       |
| `/api/agent/analysis-batches/{batchId}`        | GET    | Poll a batch                                         |
| `/api/agent/analysis-batches/{batchId}/export` | GET    | Export a completed batch                             |