Create region
create_regionCreates a named region from a timeline range on every track whose clip fully contains it (the GUI's Create Region command). The arrangement itself is unchanged. The name must not be taken by another region (error name_taken).
Instructions
Creates a named region from a timeline range on every track whose clip fully contains it (the GUI's Create Region command). The arrangement itself is unchanged. The name must not be taken by another region (error name_taken).
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>",
"name": "<name>",
"start": "<start>",
"end": "<end>"
},
"name": "create_region"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Range end (must be after start) | |
| name | Yes | Name for the new region | |
| 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 | Yes | Range start, e.g. 23 for bar 23 | |
| project | Yes | Path to the .audium project package (absolute paths recommended) |