# readers

> Reference for the readers tool of Author: beta readers, with every action and the arguments you can pass.

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

Beta-reader links (a frozen version) and their comments.

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

## Actions

| Action | What it does |
|---|---|
| `share` | A beta-reader link to a frozen version (the address is shown once). |
| `shares` | The book's beta-reader links. Rules: book_id. |
| `revoke` | Revoke a beta-reader link. Rules: share_id. |
| `comments` | Reader comments as threads. Rules: book_id, scene_id?, status? open\|resolved\|all, share_id?: reader comments as threads (quote, name, scene). |
| `reply` | Reply to a reader's comment (the reader sees it). Rules: comment_id, body (the reader sees it under their comment). |
| `resolve` | Resolve a reader comment (undo reopens it). Rules: comment_id, undo?. |
| `delete_comment` | Delete a reader comment. Rules: comment_id. |

## Arguments we have checked

### readers · share

A beta-reader link to a frozen version (the address is shown once).

- `book_id` (required)
- `chapter_ids`
- `days`
- `label`
- `mode`
- `version_id`

### readers · shares

The book's beta-reader links. Rules: book_id.

- `book_id` (required)

### readers · revoke

Revoke a beta-reader link. Rules: share_id.

- `share_id` (required)

### readers · comments

Reader comments as threads. Rules: book_id, scene_id?, status? open|resolved|all, share_id?: reader comments as threads (quote, name, scene).

- `book_id` (required)
- `scene_id`
- `share_id`
- `status`

### readers · reply

Reply to a reader's comment (the reader sees it). Rules: comment_id, body (the reader sees it under their comment).

- `body` (required)
- `comment_id` (required)

### readers · resolve

Resolve a reader comment (undo reopens it). Rules: comment_id, undo?.

- `comment_id` (required)
- `undo`

### readers · delete_comment

Delete a reader comment. Rules: comment_id.

- `comment_id` (required)

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

> [!NOTE]
> Summarise readers' comments for the author. Do not resolve them on the author's behalf unless asked.