Docs: Tool reference
changelog toolset

publish_changelog_entry

Publish a changelog entry. Publishes an entry now, or at publish_at (ISO time in the future: it goes live then, within a minute). Then, once, subscribers are emailed (notify_subscribers, default true) and so are followers of the linked posts (notify_linked_voters, default false). If the public changelog is off when it goes live, nobody is emailed, not even after it's turned on, and the entry stays hidden until then. Republishing never emails again. Managers and owners.

Toolset
changelog
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/changelog/{entry}/publish
Behavior
changes dataidempotent

Input

FieldTypeDescription
entryrequiredstringEntry ID (chg_…) or slug.
publish_atstring (date-time)Schedule for this time (UTC ISO 8601).
notify_subscribersboolean Default: true.
notify_linked_votersboolean Default: false.
expected_versioninteger

Output

FieldTypeDescription
idrequiredstringID with prefix "chg_"
slugrequiredstring
titlerequiredstring
labelsrequiredarray of object
staterequiredone of: draft, scheduled, published, unpublisheddraft, scheduled (goes live at publish_at), published or unpublished. A scheduled entry whose time has come reads as published.
publish_atrequiredstring (date-time) or null
published_atrequiredstring (date-time) or nullWhen it went live.
linked_post_countrequiredinteger
urlrequiredstringIts page on the portal (live entries) or in the admin (others).
versionrequiredinteger
updated_atrequiredstring (date-time)
bodyrequiredstringMarkdown.
linked_postsrequiredarray of object
notify_subscribersrequiredbooleanEmail subscribers when it first goes live. False if the emails went to nobody.
notify_linked_votersrequiredbooleanEmail followers of the linked posts when it first goes live. False if the emails went to nobody.
emailedrequiredbooleanWhether publication emails went to anyone. They go out once, ever, when it first goes live, and only if the public changelog is on then.
portal_urlrequiredstring or nullThe public permalink once it's live.
admin_urlrequiredstring or null
created_atrequiredstring (date-time)
changedrequiredboolean

Calling it

// MCP: tools/call
{ "name": "publish_changelog_entry", "arguments": {"entry":"<string>"} }

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