Docs: Tool reference
changelog toolset

save_changelog_entry

Save a changelog entry. Creates a draft changelog entry (no id) or edits one (id). Body is Markdown, images by URL. labels are label names; linked_posts are post IDs or slugs, which then show "Shipped in …". Saving never publishes or emails; use publish_changelog_entry. Contributors edit drafts; managers edit any entry.

Toolset
changelog
Who can call it
OwnersManagersContributorsAPI keys
REST
PUT /api/v1/w/{workspace}/changelog
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
idstringEntry ID (chg_…) or slug.
titlestring
bodystring
labelsarray of string
linked_postsarray of string
expected_versioninteger
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

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)

Calling it

// MCP: tools/call
{ "name": "save_changelog_entry", "arguments": {} }

// Typed client
await carechannel.save_changelog_entry({});