# books

> Reference for the books tool of Author: books, novellas and short stories, with every action and the arguments you can pass.

Source: https://author.geenius.io/docs/reference/books/

The books of this workspace: list, read, create, update and delete.

Call it as `geenius_author(tool: "books", action: "<action>", args: {...})` through Geenius OS.

## Actions

| Action | What it does |
|---|---|
| `list` | The books of this workspace; search filters by title. Rules: search?. |
| `get` | One book: its words, scenes, status mix and open issues. Rules: book_id: the book, words, scenes, status mix, open issues. |
| `create` | A new book. |
| `update` | Change a book's details. Rules: book_id + any of those (those of book_create). |
| `delete` | Delete a book (its maker or an owner/admin). Rules: book_id. |

## Arguments we have checked

### books · list

The books of this workspace; search filters by title. Rules: search?.

- `search`

### books · get

One book: its words, scenes, status mix and open issues. Rules: book_id: the book, words, scenes, status mix, open issues.

- `book_id` (required)

### books · create

A new book.

- `calendar`
- `collection_id`
- `epoch`
- `form`
- `language`
- `pen_name`
- `pov_mode`
- `status`
- `subtitle`
- `synopsis`
- `target_words`
- `tense`
- `title` (required)

### books · update

Change a book's details. Rules: book_id + any of those (those of book_create).

- `book_id` (required)
- `calendar`
- `collection_id`
- `epoch`
- `form`
- `language`
- `pen_name`
- `pov_mode`
- `status`
- `subtitle`
- `synopsis`
- `target_words`
- `tense`
- `title`

### books · delete

Delete a book (its maker or an owner/admin). Rules: book_id.

- `book_id` (required)

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "list"`. The server answers from its own definitions, so that answer is always current.