Docs: Tool reference
triage toolset

bulk_update_posts

Update many posts at once. Changes up to 200 posts at once, chosen by post_ids or a filter (DSL, as in search_posts): status, owner, tags to add or remove, board, category. All or nothing, and recorded as one audit event, so undo_action reverses the whole batch. notify (default false) emails followers about status changes. Always dry_run first to see counts and emails; then confirm: true. Managers and owners.

Toolset
triage
Who can call it
OwnersManagersAPI keys
REST
POST /api/v1/w/{workspace}/posts/bulk
Behavior
changes datadestructive (confirm: true, dry_run)idempotent

Input

FieldTypeDescription
post_idsarray of string
filterobjectFilter DSL (Appendix A). A condition is {"field","op","value"}; groups are {"all":[...]}, {"any":[...]} or {"not":{...}}, nested up to 3 deep. Fields: text, board, category, status, status_type, author, moderation_state, tag, owner, has_owner, on_roadmap, eta, author_company, voter_company, voter_segment, mrr_at_stake, votes, comments, created_at, updated_at, status_changed_at, custom.<key>, votes_priority.<level>. Operators: eq, neq, in, nin (lists), gt, gte, lt, lte, between ([low, high]), contains (text), exists (category), within_days (dates). Example: {"all":[{"field":"board","op":"eq","value":"bugs"},{"field":"votes","op":"gte","value":10}]}
setrequiredobject
notifybooleanEmail followers about status changes (default false). Default: false.
confirmbooleanMust be true to perform this destructive action, unless dry_run is true.
dry_runbooleanPreview the result without changing anything.

Output

FieldTypeDescription
matchedrequiredinteger
changedrequiredinteger
post_idsrequiredarray of stringThe posts that changed.
emailsrequiredintegerPeople who will be emailed (status changes with notify).

Calling it

// MCP: tools/call
{ "name": "bulk_update_posts", "arguments": {"set":"<object>"} }

// Typed client
await carechannel.bulk_update_posts({"set":"<object>"});