Docs: Tool reference
triage toolset

set_post_eta

Set a post's ETA. Sets when a post is expected to ship, as a month ("2027-03") or a quarter ("2027-Q1"), or clears it with null. ETAs are public: customers see them on the portal. Managers and owners. Nobody is emailed.

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

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
etarequiredstring or null"2027-03", "2027-Q1", or null.

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": "set_post_eta", "arguments": {"post":"<string>","eta":"<string or null>"} }

// Typed client
await carechannel.set_post_eta({"post":"<string>","eta":"<string or null>"});