Edit region
set_regionRenames a region and/or retrims its source-relative range (clamped to the source audio). Clips have no length of their own, so a retrim affects every clip using the region.
Instructions
Renames a region and/or retrims its source-relative range (clamped to the source audio). Clips have no length of their own, so a retrim affects every clip using the region.
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": {
"project": "<project>",
"region": "<region>"
},
"name": "set_region"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | New source-relative end (exclusive with length) | |
| task | No | Name of the task this edit is part of, e.g. "remove speech pauses". In the open app, all edits with the same task name become one undo step: keep the name for every call of the task and change it when the next task starts. Without a task name, all edits of this session share one step | |
| unit | No | Unit for positions (default bars; bars/beats are 1-based, seconds/clocks absolute) | |
| start | No | New source-relative start | |
| track | No | Track id, to disambiguate same-named regions | |
| length | No | New length, keeping the start | |
| region | Yes | Name of the region to edit | |
| rename | No | New name (must not collide with an existing region) | |
| project | Yes | Path to the .audium project package (absolute paths recommended) |