Change a sound: make a new version of it
r3_sound_updateChange a sound the account owns: overrides {seed, duration, channels} applied to its own recipe, or a whole new recipe (read the current one with r3_sound_read, change it, pass it here; r3_docs_read("SOUND_RECIPES.md") has the format). The sound itself never changes: the change is saved as a new version under the same name (the user's audio list shows the latest), with a new url, and every project and release using an older version keeps it. Give name only to make a separate copy under that name instead. The same recipe as the latest version saves nothing. The answer names the user's projects still on an older version (r3_component_set moves an Audio component's url). An invalid change is refused with the path of the problem. Counts toward the 60 sounds an hour.
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": {
"audioId": "<audioId>"
},
"name": "r3_sound_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only to make a separate COPY under this name. Default: a new version of the same sound, same name. | |
| recipe | No | Or a whole new recipe (format "r3-sound-recipe", version 1). | |
| audioId | Yes | The sound to change (the account's own). | |
| overrides | No | Changes to its recipe: {seed, duration, channels}. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| loop | Yes | ||
| name | Yes | ||
| stats | Yes | ||
| answer | Yes | This answer in words: what was done, what R3 measured, decided or refused, and what to do next. The same text as the result's text block. Read it: the fields beside it are the data, this is the guidance. | |
| audioId | Yes | ||
| version | Yes | ||
| seamless | Yes | ||
| warnings | Yes | ||
| listenUrl | Yes | ||
| unchanged | Yes | ||
| durationMs | Yes | ||
| previousId | Yes | ||
| previousInUse | Yes |