bulk_update_calls
Update every call matching a filter with a single action. Add tags, set notes, mark spam, or change lead status. Preview changes with dry_run before committing. Up to 500 calls per invocation.
Instructions
Apply the same update to every call matching a filter.
Useful for: "tag every Bing call this month as low-priority",
"mark all <30s unanswered calls from this number as spam",
"add a note to every call from a specific landing page". Replaces
dozens of sequential update_call invocations with one tool call.
Safety: dry_run=True by default — returns a preview of which
calls WOULD be updated without actually writing. Pass dry_run=False
to commit. Hard cap of 500 calls per invocation to prevent runaway
bulk operations.
Args:
company_id, days, source, answered: filter — same semantics as
list_calls. At least one must be provided to avoid
"update everything ever".
set_tags_add: tag names to ADD to each matched call (preserves
existing tags). Mutually compatible with other set_* fields.
set_note: note text to set on each matched call (replaces existing).
set_lead_status: e.g. 'good_lead', 'not_a_lead'.
set_spam: True to mark spam, False to unmark.
dry_run: If True (default), return preview only. False = commit.
account_id: Auto-resolves if omitted.
Returns:
- If dry_run: {"matched": N, "would_update": [...]}
- Else: {"matched": N, "updated": M, "failed": [...]} per call
Performance note: when set_tags_add is used, the commit phase
issues 1 extra GET per call to fetch fresh tags before merging
(race protection against concurrent tag writes). For a max
bulk of 500 calls, this is ~2× the latency vs other set_*
fields. Other update fields (note, lead_status, spam) skip the
extra GET.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | No | ||
| days | No | ||
| source | No | ||
| answered | No | ||
| set_tags_add | No | ||
| set_note | No | ||
| set_lead_status | No | ||
| set_spam | No | ||
| dry_run | No | ||
| account_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |