Chapters

A chapter belongs to a book, has an integer order (1-based), a title and summary from the outliner, plus the generated prose. Edit or refetch chapters here; generation lives under Generation.

List chapters of a book

GET/v1/books/{bookId}/chaptersscope: books:read

Returns chapters in order.

Read a single chapter

GET/v1/books/{bookId}/chapters/{chapterId}scope: books:read

Edit chapter content

PATCH/v1/books/{bookId}/chapters/{chapterId}scope: books:write

Patch title, summary, content, or notes. Setting content automatically snapshots the prior version (so it’s recoverable), recomputes wordCount / readingTimeSec, and invalidates any audio narration on the chapter.

curl -X PATCH "$ANTHRA_BASE/books/$BOOK/chapters/$CH" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "title": "Across the Pyrenees", "notes": "tighten dialogue" }'

Audio

audioUrl and audioStatus on a chapter row reflect the most recent narration. To request narration, see Generation → narrate.