Replace Clip Media
replace_clip_mediaReplace a timeline clip's media while preserving trim, position, and linked audio—but this tool performs no mutation because the legacy method cannot guarantee preservation.
Instructions
Unavailable by design: the legacy ExtendScript overwrite route cannot prove that replacing media preserves the original clip's trim, position, linked audio, or adjacent clips, so this tool performs no mutation.
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": {
"clip_node_id": "<clip_node_id>",
"new_item_id": "<new_item_id>"
},
"name": "replace_clip_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| new_item_id | Yes | Node ID or name of the new source project item | |
| clip_node_id | Yes | Node ID of the timeline clip to replace media on |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Tool-specific result data when ok is true; on failure, diagnostic detail when the tool provides it. | |
| tool | Yes | The registered MCP tool name. | |
| error | No | Failure detail when ok is false. |