rename_session_object
Rename an exact track, Group, Return, scene, or Session clip with identity checks and undo-safe revalidation, reporting partial outcomes.
Instructions
Rename an exact track, Group, Return, scene or Session clip. Binds native identity/layout and prior label; rechecks at undo entry. Reports partial outcomes. Return labels omit the bus letter. Updated bridge required.
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": {
"expectedStateVersion": "<expectedStateVersion>",
"targetType": "<targetType>",
"targetId": "<targetId>",
"name": "<name>"
},
"name": "rename_session_object"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | New name; Session clip labels allow up to 255 characters without controls. For Return Tracks omit the automatic bus-letter prefix. | |
| dryRun | No | False executes with token and hash. | |
| trackId | No | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| targetId | Yes | Stable target ID. | |
| targetType | Yes | ||
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||