scenario_tool_execute_write
ManagementExecute Write Tool
Execute a write-class tool from the Scenario tool catalog by name. Write-class tools create or modify data (never irreversibly destroy it).
Only tools whose permission is "write" run here — read- or delete-class tools are rejected with the correct executor named.
For catalog-only tools. If the target is in the default tool list, call it directly — scenario_tools_search reports listed: true for those; routing one here buys nothing.
Use scenario_tools_search first to find the tool name, its permission class, and its inputSchema. Parameters are validated against the target tool's schema before execution; defaults are applied server-side.
Args:
- name: required — catalog tool name exactly as returned by scenario_tools_search
- parameters: optional — arguments matching the tool's inputSchema (include team_id and project_id here whenever the target's inputSchema declares them — many require project_id outright, and OAuth requires both)
Returns: the target tool's result, plus a routing note when the target was directly callable.
Example: scenario_tools_search(query="create a collection") -> scenario_tool_execute_write(name="collection_create", parameters={"team_id": "team_xxx", "project_id": "project_xxx", "name": "Hero Assets"})
Don't use when: the target's permission is read/delete (use scenario_tool_execute_read / scenario_tool_execute_delete).
open-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | ✓ | Catalog tool name exactly as returned by scenario_tools_search. |
| parameters | record | [object Object] | Arguments matching the tool's inputSchema from scenario_tools_search. Defaults are applied server-side. |