Docs: Tool reference
core toolset

update_comment

Edit a comment. Replaces a comment's Markdown body (and, for the team, its mentions). Authors edit their own; managers and owners edit any. Visibility can't change. Pass expected_version from list_comments to avoid overwriting another edit. Teammates newly mentioned are notified (and emailed, per their settings); nobody else is emailed.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keys
REST
PATCH /api/v1/w/{workspace}/comments/{comment}
Behavior
changes dataidempotent

Input

FieldTypeDescription
commentrequiredstringID with prefix "cmt_"
bodyrequiredstringMarkdown. Raw HTML is shown as text, not rendered.
mentionsarray of stringReplaces the mention list; omit to keep it.
expected_versioninteger

Output

FieldTypeDescription
idrequiredstringID with prefix "cmt_"
post_idrequiredstringID with prefix "pst_"
parent_idrequiredstring or nullThe comment this replies to; null at the top level.
authorrequiredobject
bodyrequiredstring or nullMarkdown; null once the comment is deleted.
visibilityrequiredone of: public, internalpublic: everyone who can see the post. internal: team members only.
mentionsrequiredarray of object
deletedrequiredbooleanShown only to keep a deleted comment's replies in place.
edited_atrequiredstring (date-time) or null
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)

Calling it

// MCP: tools/call
{ "name": "update_comment", "arguments": {"comment":"<string>","body":"<string>"} }

// Typed client
await carechannel.update_comment({"comment":"<string>","body":"<string>"});