add_shot_media_ref
Add a fine-grained media reference to a shot: image, video, startFrame, endFrame, or referenceFrame. Can also update legacy imageMediaId/videoMediaId for compatibility.
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": {
"workspaceId": "<workspaceId>",
"editId": "<editId>",
"shotId": "<shotId>",
"mediaId": "<mediaId>",
"role": "<role>"
},
"name": "add_shot_media_ref"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | How this media is used in the shot | |
| order | No | Tab/order within the shot; auto-appends if omitted | |
| editId | Yes | The edit ID | |
| shotId | Yes | The shot ID | |
| mediaId | Yes | Referenced MediaDocV2 ID | |
| workspaceId | Yes | The workspace ID | |
| versionOverride | No | Optional media version override | |
| replaceExistingRole | No | Remove existing refs with the same role before adding this one | |
| alsoSetPrimaryMediaId | No | For image/video roles, also set imageMediaId/videoMediaId |