add_sfx
frapea's BUILT-IN sound-effects pack — synthesized, licence-free, no API key, no download wait. Reach for this FIRST; use search_sounds only for something the pack does not cover (ambience, foley, a specific real-world object). Call with no ids to get the catalogue: each sound carries what it sounds like AND when to use it. Call with ids to copy them into the project's media pool as sfx-<id>.wav at the Library root; each result gives a mediaRef ready for add_clips on an audio track. Adding a sound already in the project is a no-op that returns its existing mediaRef.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Convenience: a single sound id. | |
| ids | No | Sound ids to add (e.g. ['whip','thump','ding']). Omit to list the pack. | |
| token | Yes | The session token `connect` returned. Pass it on every call — it says which browser to drive. | |
| projectId | Yes | Project id from get_projects. |