Docs: Tool reference
triage toolset

moderate_post

Approve or reject a post. Decides a post: approve shows it to everyone who can see the board, emails its author that it's live (once per post, unless they turned off post updates) and emails the board's followers about a new post per their settings. reject or spam hide it from everyone but the team (its author keeps seeing it) and email nobody. Reversible: call again with another action. To stop a spammer, follow up with block_user. Managers and owners.

Toolset
triage
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/posts/{post}/moderation
Behavior
changes dataidempotent

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
actionrequiredone of: approve, reject, spam

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).
changedrequiredboolean
previous_staterequiredone of: approved, pending, rejected, spamOnly approved posts are shown to end users other than the author.

Calling it

// MCP: tools/call
{ "name": "moderate_post", "arguments": {"post":"<string>","action":"<one of: approve, reject, spam>"} }

// Typed client
await carechannel.moderate_post({"post":"<string>","action":"<one of: approve, reject, spam>"});