review_block

com.kythene/kythene · Verify this server

Flag one block of a renderable artifact and optionally comment on it - the block-level equivalent of comment/approve. First read the artifact with get_artifact to get each block's `anchor` and `text`, then call this once per block. Address a block by `anchor` (preferred) or by `quoted_text` (a verbatim snippet; the server resolves it). `status` is exactly one of: needs_review = look at this again (also auto-set when a flagged block changes on re-publish); needs_work = changes required; done = the needed action is complete; approved = signed off; reject_remove = this block should be removed. A comment is allowed only once a status is set. Set status empty to clear a flag. If a block was REWRITTEN since it was flagged (get_artifact shows it with `rewritten: true` and no live anchor), address its thread by `annotation_id` instead of an anchor - that is the only way to close or reply to it. Only works when the collection has requested review.