Use the Speak AI MCP server tool update_multiple_fields to set custom field values
across media in a single batch operation, overwriting existing values.
What does it do?
Set custom field values across media in a single batch operation, overwriting
existing values. Scope the update with mediaIds, or with folderId to update
every media in that folder; when both are given only mediaIds is used. Empty
values are skipped, so this cannot clear a field. Each value that changes fires your
field_updated automations, whose steps can send email, post to Slack, call webhook
URLs or run connected third-party app actions. Shared dashboard links cache widget
data, so field and media edits can take up to about 5 minutes to show for date
ranges that include today (15 at most) and up to about 17 minutes for past ranges
(60 at most); any dashboard update refreshes it at once.
Parameters
update_multiple_fields takes 3 parameters, 1 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
folderId |
string | No | Apply the field values to all media in this folder |
mediaIds |
array of string | No | Apply the field values to these specific media files |
fields |
array | Yes | Array of field id/value pairs to set |
Behaviour
The Speak AI MCP server publishes these behaviour hints for
update_multiple_fields.
- Can change data in your workspace.
- Can delete or overwrite data. Use with care.
- Repeating an identical call is safe.
- Can reach systems outside Speak AI.
Related
- Fields lists the rest of the Fields category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.