readers

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

Updated 17 October 2026 · View as Markdown

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

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

Actions#

ActionWhat it does
shareA beta-reader link to a frozen version (the address is shown once).
sharesThe book's beta-reader links. Rules: book_id.
revokeRevoke a beta-reader link. Rules: share_id.
commentsReader comments as threads. Rules: book_id, scene_id?, status? open|resolved|all, share_id?: reader comments as threads (quote, name, scene).
replyReply to a reader's comment (the reader sees it). Rules: comment_id, body (the reader sees it under their comment).
resolveResolve a reader comment (undo reopens it). Rules: comment_id, undo?.
delete_commentDelete 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)