comment verbs

Verbs in the comment namespace. Each verb is auto-registered via the @verb decorator and exposed simultaneously as an HTTP route, an MCP tool, and an in-process Python callable (SPEC-001 §3).

Verbs in this namespace: 4

---

scidex.comment.delete

# write verb
async def scidex_comment_delete(
    args: CommentDeleteIn,
    ctx: Context,
) -> CommentDeleteOut: ...

Soft-delete a comment (author or scidex-admin).

Input fields

Field	Type	Required
comment_id	string	yes

Output: CommentDeleteOut

---

scidex.comment.react

# write verb
async def scidex_comment_react(
    args: CommentReactIn,
    ctx: Context,
) -> CommentReactOut: ...

Toggle an emoji reaction on a comment (any signed-in actor).

Input fields

Field	Type	Required
comment_id	string	yes
emoji	string	yes

Output: CommentReactOut

---

scidex.comment.thread

# read verb
async def scidex_comment_thread(
    args: CommentThreadIn,
    ctx: Context,
) -> CommentThreadOut: ...

Fetch threaded comments for an artifact as a nested tree.

Input fields

Field	Type	Required
artifact_id	string	yes
depth	integer	no
limit	integer	no
offset	integer	no

Output: CommentThreadOut

---

scidex.comment.update

# write verb
async def scidex_comment_update(
    args: CommentUpdateIn,
    ctx: Context,
) -> CommentUpdateOut: ...

Edit the body of a comment you authored (author-only).

Input fields

Field	Type	Required
comment_id	string	yes
body	string	yes
base_content_hash	`string	null`

Output: CommentUpdateOut

---