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.
The post's ID (pst_…) or slug (the last part of its portal URL).
include
array of one of: status_history
Extra detail: status_history (every status change, oldest first).
Output
Field
Type
Description
idrequired
string
ID with prefix "pst_"
workspace_idrequired
string
ID with prefix "ws_"
slugrequired
string
titlerequired
string
boardrequired
object
categoryrequired
object or null
statusrequired
object
authorrequired
object
moderation_staterequired
one of: approved, pending, rejected, spam
Only approved posts are shown to end users other than the author.
ownerrequired
object or null
The responsible team member; null when unassigned, and always for end users.
etarequired
object or null
tagsrequired
array of object or null
Internal tags; null for end users, who never see tags.
merged_intorequired
object or null
Set when merged into another post: this one is read-only and redirects there.
vote_countrequired
integer
comment_countrequired
integer
Public comments and replies.
voted_by_yourequired
boolean or null
Whether you have voted on it; null unless you're an end user.
shipped_inrequired
object or null
The published changelog entry that announced it, if any.
followed_by_yourequired
boolean or null
Whether you follow it (follow / unfollow); null for API keys and visitors.
emailable_followersrequired
integer or null
How 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_atrequired
string (date-time)
last_activity_atrequired
string (date-time)
versionrequired
integer
created_atrequired
string (date-time)
updated_atrequired
string (date-time)
portal_urlrequired
string (uri)
admin_urlrequired
string (uri) or null
Admin inbox link; null for end users.
bodyrequired
string
Markdown, as written.
attachmentsrequired
array of object
In the order they were attached.
created_by_member_idrequired
string or null
The member who posted on the author's behalf; null otherwise or for end users.
fieldsrequired
object
Custom field values by key; customers see public fields only.
roadmapsrequired
array of object or null
Internal roadmaps it's on (team only; null for customers).
mrr_at_stakerequired
number or null
Summed MRR of the distinct companies of its voters (team only).