Docs: Tool reference
core toolset

get_post

Get a post. Returns one post in full: title, Markdown body, board, category, status, author, vote and comment counts, version (for update_post's expected_version) and URLs. Pass its ID or slug. End users can't open posts on private boards. No side effects.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keysVisitors
REST
GET /api/v1/w/{workspace}/posts/{post}
Behavior
read-onlyidempotent

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
includearray of one of: status_historyExtra detail: status_history (every status change, oldest first).

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).
status_historyarray of object

Calling it

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

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