conduyt_ai_task_segment_and_act
Preview contact segments by filter and see what a bulk tag, assignment, or field update would change, returning matched counts without persisting.
Instructions
AI task (PREVIEW ONLY): preview segmenting contacts by a filter and applying one action (add/remove a tag, assign to a user, or update a field) to the whole segment. Returns the matched count and what WOULD change, without persisting. Executing this is intentionally restricted to a human session in the app; agent/API-key callers can only preview.
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": {
"filter": "<filter>",
"action": "<action>"
},
"name": "conduyt_ai_task_segment_and_act"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max contacts to act on (default 100, max 1000) | |
| action | Yes | The action to apply to the whole segment | |
| filter | Yes | Segment selection criteria |