kythene.v1.KytheneService

ReviewBlock

ReviewBlock flags one block of a renderable artifact and optionally comments on it - block-level review. Read the artifact first (get_artifact) for each block's anchor + text; address a block by anchor or by quoting its text.

post/kythene.v1.KytheneService/ReviewBlock

Request

  • Base URL: https://kythene.com (the document declares no server; this is the origin it was published from)
  • URL: https://kythene.com/kythene.v1.KytheneService/ReviewBlock
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

collectionIdstring

the collection you are reviewing (access + opt-in)

artifactIdstring

the artifact within it (from get_artifact)

anchorstring

address by anchor (preferred) ...

quotedTextstring

... or by quoting the block's text (server resolves)

annotationIdstring

annotation_id addresses an existing thread by id instead - the ONLY way to reach one whose block was rewritten (from get_artifact's block.annotation_id).

statusstring

status is one of needs_review, needs_work, done, approved, reject_remove. Empty clears the flag.

commentstring

optional; allowed only when a status is set

spacestring

space optionally selects which of your spaces to act in (an id or name from list_spaces). Omit it when you belong to a single space.

Response

Success

anchorstring
statusstring

Changes

No recorded changes to this operation across all 1 revision of this API.