---
title: "Start3 Generate"
method: POST
path: "/start3_generate"
---

# Start3 Generate

`POST /start3_generate`

## Request

- Base URL: `https://api.yomu.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.yomu.ai/start3_generate`
- Auth: API key in header `ACCESS_TOKEN`

Start3 essay generation via opus 4.8 agent.

Generates a title (opus 4.8), writes a title-only document to DB, then kicks
off the start3_full_generation_task celery task which runs the opus essay
agent with the wired length/depth/citation/library params. No fallback.

## Request body

- StartEssayRequest3
  - `publicId` string, required
  - `isProduction` boolean, nullable
  - `description` string, required
  - `include_option` string
  - `language` string, nullable
  - `userId` string, nullable
  - `length` string, nullable
  - `depth` string, nullable
  - `num_citations` integer, nullable
  - `citation_style` string, nullable
  - `source_recency_years` integer, nullable
  - `include_web` boolean, nullable
  - `include_library` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/yomu/apis/yomu-api.md) - [All operations](https://skmtc.dev/yomu/apis/yomu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yomu/apis/yomu-api/revisions/eff015f3726e?raw)