Batch Update Conversations
batch_update_conversationsApply one action—mark read or unread, star, unstar, archive, or delete—to many Inbox conversations at once, with a preview and confirmation before changes. Only affects your own inbox.
Instructions
Apply one action (mark read or unread, star, unstar, archive or delete) to many Inbox conversations at once. Only affects your own inbox. [NEEDS CONFIRMATION: call it once for a preview and a confirm_token, show the preview to the user, and only if they say yes call it again with the same arguments, confirm=true and that confirm_token. Apps that can ask the user directly show a confirmation instead.]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"conversation_ids": "<conversation_ids>",
"event": "<event>"
},
"name": "batch_update_conversations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | Yes | Action to apply to every listed conversation. "destroy" deletes them from your inbox for good. | |
| confirm | No | Set to true together with confirm_token to carry out a request you already previewed. | |
| confirm_token | No | The one-time token from the preview. Only use it after the user has said yes. | |
| conversation_ids | Yes | Inbox conversation IDs (numeric strings) from list_conversations. |