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
| Field | Type | Description |
|---|---|---|
post_ids | array of string | |
filter | object | Filter 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}]} |
setrequired | object | |
notify | boolean | Email followers about status changes (default false). Default: false. |
confirm | boolean | Must be true to perform this destructive action, unless dry_run is true. |
dry_run | boolean | Preview the result without changing anything. |
Output
| Field | Type | Description |
|---|---|---|
matchedrequired | integer | |
changedrequired | integer | |
post_idsrequired | array of string | The posts that changed. |
emailsrequired | integer | People 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>"});