Update or comment on a proof

With the qHash in hand, edit the title, tags or visibility, or leave one vote or comment per call. Omit walletAddress when signed in.

What changes

The title helps people recognize a proof. Tags are short values for retrieval with proofable_proofs_get. Votes and comments are feedback signals; they never mark a claim correct or approved. Verified content, verifier results and ownership stay unchanged. Owners can vote on their own proofs.

Auth	Access
None	Not available
Bearer	Title, tags and visibility changes require ownership. Public proof feedback requires sign-in; private proof feedback requires ownership (Auth).

Input

{
  "qHash": "0x...",
  "vote": "up"
}

Field	Notes
`qHash`	Required. The proof ID to update or review.
`title`	New title. Omit to keep, `null` to clear.
`addTags`	Exact retrieval tags to add.
`removeTags`	Exact existing tags to remove.
`visibility`	`public` (discoverable), `unlisted` (link-only), or `private` (owner-only). Only the owner’s own session can change it. Making a shared proof private revokes public access.
`disclosePortableProof`	Allow the full portable envelope on anonymous reads of this public proof by ID. Default `false`.
`vote`	`up`, `down`, or `clear` to change your vote.
`comment`	Add a comment. Use `parentId` to reply to an existing comment.
`parentId`	Optional comment ID to reply to. Requires `comment`.
`walletAddress`	Optional owner wallet. Omit when signed in to use the current account.

Send one kind of update per call, either metadata, one vote, or one comment. A delegated agent needs the manage_proofs action.

Response

Returns the proof ID and the result of the update, vote, or comment.

Read it back

Use proofable_proofs_get with qHash and includeComments: true to read comments. Use tags for an exact tag match, tagPrefix for a namespace, or tagContains for tag text.

Assistant output

Proofable: Feedback saved on this proof.

Avoid raw JSON, and never present votes as proof of correctness or approval.

Overview

MCP

JavaScript SDK

HTTP API

Verifier catalog

Standards

Update or comment on a proof

What changes

Input

Response

Read it back

Assistant output

​What changes

​Input

​Response

​Read it back

​Assistant output

What changes

Input

Response

Read it back

Assistant output