Docs: Tool reference
triage toolset

change_post_status

Change a post's status. Moves a post to another status (name or ID, e.g. "Planned") and records it in the post's history. Optionally posts a public comment explaining the change. With notify (default true), the post's customer followers (its author, voters, commenters and anyone who followed it or a duplicate merged into it, unless they unfollowed or opted out) get one email within a minute; get_post's emailable_followers counts them; pass notify: false for quiet cleanups. Setting the current status again does nothing. Managers and owners.

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

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
statusrequiredstringStatus name or ID, e.g. "Planned".
commentstringA public note shown on the post and quoted in the email. Team members only.
notifybooleanEmail the post's followers (default true). Default: true.

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
notifyrequiredbooleanWhether emails were queued.
previous_statusrequiredstring or null

Calling it

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

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