---
title: "Create a draft book"
method: POST
path: "/books"
---

# Create a draft book

`POST /books`

## Request

- Base URL: `https://anthra.com/api/v1`
- URL: `https://anthra.com/api/v1/books`
- Auth: HTTP bearer

## Request body

- object
  - `premise` string, required
  - `title` string
  - `genre` string
  - `audience` string
  - `author` string
  - `modelTier` 'haiku' | 'sonnet' | 'opus'

## Response `201`

Created

- object
  - `data` Book
    - `id` string, uuid
    - `title` string
    - `subtitle` string, nullable
    - `author` string, nullable
    - `premise` string
    - `genre` string, nullable
    - `audience` string, nullable
    - `toneStyle` string, nullable
    - `description` string, nullable
    - `coverColor` string, nullable
    - `coverImageUrl` string, nullable
    - `status` 'draft' | 'outlining' | 'writing' | 'ready' | 'published'
    - `visibility` 'private' | 'unlisted' | 'public'
    - `slug` string, nullable
    - `modelTier` 'haiku' | 'sonnet' | 'opus'
    - `language` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `publishedAt` string, date-time, nullable
    - `readerUrl` string, nullable

---

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