Use the Speak AI MCP server tool update_media_metadata to update metadata fields
(name, description, tags, status) for an existing media file.
What does it do?
Update metadata fields (name, description, tags, status) for an existing media file. Sends the media.updated event to the workspace’s webhooks and Slack channels if any are configured.
Parameters
update_media_metadata takes 8 parameters, 2 of them required.
| Name | Type | Required | Description |
|---|---|---|---|
mediaId |
string | Yes | Unique identifier of the media file |
name |
string | Yes | Display name for the media (required: the server replaces the metadata) |
description |
string | No | Description or notes for the media |
folderId |
string | No | Move media to this folder ID |
tags |
array of string | No | Array of tags to assign to the media |
status |
string | No | Media status value |
remark |
string | No | Internal remark or note |
manageBy |
string | No | User ID to assign management of this media to |
Behaviour
The Speak AI MCP server publishes these behaviour hints for update_media_metadata.
- 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
- Media lists the rest of the Media category.
- Tool reference lists every Speak AI MCP server tool.
- MCP server covers setup, supported clients, and what agents can do once connected.