Docs: Tool reference
core toolset

delete_post

Delete a post. Deletes a post: it disappears from the portal, search and counts, and can be restored for 30 days. Authors delete their own posts (end users only while nobody else has voted); managers and owners delete any. Destructive: pass confirm: true, or dry_run: true to preview. Nobody is emailed.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keys
REST
DELETE /api/v1/w/{workspace}/posts/{post}
Behavior
changes datadestructive (confirm: true, dry_run)

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
expected_versionintegerThe post's version from your last read. If it changed since, the call fails instead of overwriting a newer change.
confirmbooleanMust be true to perform this destructive action, unless dry_run is true.
dry_runbooleanPreview the result without changing anything.

Output

FieldTypeDescription
deletedrequiredobject

Calling it

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

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