Docs: Tool reference
core toolset

update_post

Edit a post. Edits a post's title, Markdown body or category (null removes it; categories come from the post's board). Only fields you pass change. Authors edit their own posts; managers and owners edit any. Pass expected_version from get_post to avoid overwriting someone else's edit. Status changes use change_post_status instead. Nobody is emailed.

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

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
titlestring
bodystringMarkdown. Raw HTML is shown as text, not rendered.
categorystring or nullCategory name, slug or ID on the post's board; null to remove it.
attachment_idsarray of stringThe post's full attachment list after the edit, in order: new uploads are added, omitted ones removed. Leave out to keep them as they are.
fieldsobjectCustom field values by key (list_custom_fields). Customers can set only the fields on the board's form; null clears a value.
expected_versionintegerThe post's version from your last read. If it changed since, the call fails instead of overwriting a newer change.

Output

FieldTypeDescription
idrequiredstringID with prefix "pst_"
workspace_idrequiredstringID with prefix "ws_"
slugrequiredstring
titlerequiredstring
boardrequiredobject
categoryrequiredobject or null
statusrequiredobject
authorrequiredobject
moderation_staterequiredone of: approved, pending, rejected, spamOnly approved posts are shown to end users other than the author.
ownerrequiredobject or nullThe responsible team member; null when unassigned, and always for end users.
etarequiredobject or null
tagsrequiredarray of object or nullInternal tags; null for end users, who never see tags.
merged_intorequiredobject or nullSet when merged into another post: this one is read-only and redirects there.
vote_countrequiredinteger
comment_countrequiredintegerPublic comments and replies.
voted_by_yourequiredboolean or nullWhether you have voted on it; null unless you're an end user.
shipped_inrequiredobject or nullThe published changelog entry that announced it, if any.
followed_by_yourequiredboolean or nullWhether you follow it (follow / unfollow); null for API keys and visitors.
emailable_followersrequiredinteger or nullHow many customers a status change with notify emails: followers who can be emailed and keep post updates on. Team only (null for customers and visitors).
status_changed_atrequiredstring (date-time)
last_activity_atrequiredstring (date-time)
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
portal_urlrequiredstring (uri)
admin_urlrequiredstring (uri) or nullAdmin inbox link; null for end users.
bodyrequiredstringMarkdown, as written.
attachmentsrequiredarray of objectIn the order they were attached.
created_by_member_idrequiredstring or nullThe member who posted on the author's behalf; null otherwise or for end users.
fieldsrequiredobjectCustom field values by key; customers see public fields only.
roadmapsrequiredarray of object or nullInternal roadmaps it's on (team only; null for customers).
mrr_at_stakerequirednumber or nullSummed MRR of the distinct companies of its voters (team only).

Calling it

// MCP: tools/call
{ "name": "update_post", "arguments": {"post":"<string>"} }

// Typed client
await carechannel.update_post({"post":"<string>"});